Skip to content

Latest commit

 

History

History

codex

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
.codex-plugin
.codex-plugin
 
 
common/mcp
common/mcp
 
 
servers
servers
 
 
.mcp.json
.mcp.json
 
 
README.md
README.md
 
 
glance.test.ts
glance.test.ts
 
 
package.json
package.json
 
 

README.md

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.1

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.1
git push origin codex-v0.1.1

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)