Skip to content

README.md

Latest commit

 

History

History
104 lines (68 loc) · 2.33 KB

README.md

File metadata and controls

104 lines (68 loc) · 2.33 KB

glance.sh plugin for Codex

Codex CLI integration that adds glance.sh screenshot tools via MCP.

What it does

Adds two MCP tools:

  • glance — creates/reuses a live session and returns a URL like https://glance.sh/s/<id>
  • glance_wait — waits for the next pasted image and returns Screenshot: https://glance.sh/<token>.<ext>

The server keeps a background SSE listener alive, reconnects automatically, and refreshes sessions before they expire.

Install

Recommended (npm package):

codex mcp add glance -- npx -y @modemdev/glance-codex

Optional: pin a specific version:

codex mcp add glance -- npx -y @modemdev/glance-codex@0.1.0

Local development / manual install:

codex mcp add glance -- node /absolute/path/to/glance-agent-plugins/codex/servers/glance-mcp.js

Verify

  1. Confirm the MCP server is configured:
codex mcp list
codex mcp get glance --json
  1. Ask Codex to call glance.
  2. Open the returned https://glance.sh/s/<id> URL and paste an image.
  3. Ask Codex to call glance_wait.
  4. Confirm Codex receives Screenshot: <url>.

Update / remove

Update:

codex mcp remove glance
codex mcp add glance -- npx -y @modemdev/glance-codex

Remove:

codex mcp remove glance

Publishing (maintainers)

Releases are automated via GitHub Actions.

Prerequisite: configure NPM_TOKEN in the glance-agent-plugins repository with publish access to @modemdev/glance-codex.

  1. Bump version in codex/package.json.
  2. Commit and push to main.
  3. Create and push a matching tag:
git tag codex-v0.1.0
git push origin codex-v0.1.0

The Release codex package workflow validates tag/version alignment, checks for already-published versions, runs npm pack --dry-run, and publishes with npm provenance.

How it works

Codex calls glance
  └─▶ MCP server POST /api/session
  └─▶ returns session URL

Codex calls glance_wait
  └─▶ waits for SSE image event

User pastes image at /s/<id>
  └─▶ glance.sh emits image event
  └─▶ tool returns Screenshot: <url>

Requirements

  • Codex CLI with MCP support
  • Node.js runtime available to launch the stdio MCP server

Configuration

Optional environment variable:

  • GLANCE_BASE_URL (default: https://glance.sh)