hex/glance-agent-plugins
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Self-hosted temporary screenshot sharing for coding agents
43 commits 1 branch 5 tags 344 KiB
  • JavaScript 57.9%
  • TypeScript 41.1%
  • Shell 0.7%
  • Dockerfile 0.3%
Find a file
Exact
HexC0d3rz 227b6387cb
All checks were successful
Test / test (push) Successful in 1m6s
Details
Extend file TTL to 48 hours
2026-08-17 11:34:34 -04:00
.claude-plugin feat: polish self-hosted UI and Forgejo install 2026-07-19 13:34:01 -04:00
.forgejo/workflows ci: match registered runner labels (self-hosted, linux) 2026-07-23 12:27:59 -04:00
.github/workflows ci: match registered runner labels (self-hosted, linux) 2026-07-23 12:27:59 -04:00
backend Extend file TTL to 48 hours 2026-08-17 11:34:34 -04:00
claude feat: polish self-hosted UI and Forgejo install 2026-07-19 13:34:01 -04:00
codex feat: polish self-hosted UI and Forgejo install 2026-07-19 13:34:01 -04:00
common/mcp feat: add self-hosted glance service 2026-07-19 13:10:24 -04:00
opencode feat: polish self-hosted UI and Forgejo install 2026-07-19 13:34:01 -04:00
pi Add ZIP upload support 2026-08-02 04:16:48 -04:00
scripts deploy: re-exec after git reset so health retry is used 2026-07-23 13:16:02 -04:00
test/stubs Add repo agent guidance and sync test config (#3) 2026-03-07 11:30:36 -05:00
.dockerignore feat: add self-hosted glance service 2026-07-19 13:10:24 -04:00
.gitignore Add Vitest coverage for the Pi plugin (#2) 2026-03-07 11:05:23 -05:00
AGENTS.md feat: add self-hosted glance service 2026-07-19 13:10:24 -04:00
CLAUDE.md Add repo agent guidance and sync test config (#3) 2026-03-07 11:30:36 -05:00
compose.yaml chore: expose glance on port 2882 2026-07-19 13:13:07 -04:00
Dockerfile fix: make image volume writable 2026-07-19 13:43:14 -04:00
LICENSE Add MIT license 2026-03-07 11:32:31 -05:00
package-lock.json feat: polish self-hosted UI and Forgejo install 2026-07-19 13:34:01 -04:00
package.json feat: polish self-hosted UI and Forgejo install 2026-07-19 13:34:01 -04:00
README.md Extend file TTL to 48 hours 2026-08-17 11:34:34 -04:00
tsconfig.json feat: add first-class codex plugin directory (#13) 2026-03-08 19:45:10 -04:00
vitest.config.ts feat: add self-hosted glance service 2026-07-19 13:10:24 -04:00

README.md

Self-hosted Glance

Private, temporary file sharing for coding agents at glance.supportportal.org.

Paste, drop, or choose an image, text/log, or ZIP file in your browser and the agent receives its temporary URL over SSE. Sessions expire after 10 minutes; files expire after 48 hours.

Install the Pi extension

Install directly from this Forgejo repository—no npm package required:

pi install https://forgejo.supportportal.org/hex/glance-agent-plugins.git

Then use /glance in Pi or ask the agent to call the glance tool.

Update or remove it with:

pi update --extensions
pi remove https://forgejo.supportportal.org/hex/glance-agent-plugins.git

Pi extensions run with full system access. Review pi/glance.ts before installing.

Self-host

git clone https://forgejo.supportportal.org/hex/glance-agent-plugins.git
cd glance-agent-plugins
docker compose up -d

The service listens on 0.0.0.0:2882 and stores images in the Docker volume glance-data. Set PUBLIC_BASE_URL in compose.yaml if you use another hostname.

Your reverse proxy must:

  • Forward the public hostname to port 2882.
  • Disable buffering for /api/session/*/events.
  • Keep SSE read timeouts above five minutes.
  • Allow upload request bodies up to 20 MB.

Check it with:

curl http://127.0.0.1:2882/healthz

Development

npm ci
npm test
npm exec -- tsc --noEmit
docker compose up -d --build

License

MIT