Photon
About
A TypeScript framework that turns a single class into an MCP server, CLI tool, and web dashboard with a marketplace of 35 ready-made photons.
Details
- Author
- portel-dev
- Categories
- Developer Tools, Other
Jump to
Setup
Install Photon in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/portel-dev/photon
Follow the installation instructions in the repository README, then restart your MCP client.
photon ps: scheduled jobs, webhooks, and sessions
photon psis the operator surface for the daemon. Without arguments it prints a four-section snapshot — ACTIVE schedules, DECLARED-but- not-enrolled, WEBHOOKS, and ACTIVE SESSIONS.
photon ps # full snapshot photon ps --json # structured output for scripts photon ps --type active # one section only photon ps --base ~/Projects/kith # filter to one PHOTON_DIR
Two-step model.A@scheduledannotation in source isDECLAREDuntil enrolled. Enrollment is per-machine, persistent, and explicit:
photon ps enable newsletter:sendDigest # DECLARED → ACTIVE photon ps disable newsletter:sendDigest # ACTIVE → suppressed (survives restart) photon ps pause newsletter:sendDigest # stop firing without removing enrollment photon ps resume newsletter:sendDigest # undo pause photon ps history newsletter:sendDigest # last 20 firings: timestamp, status, error
For manual cron schedules without a@scheduledtag, use the Beam Pulse panel ("Add schedule") or callthis.schedule.create()from photon code.
this.schedule.create()(programmatic schedules) skips DECLARED and goes straight to ACTIVE. Seedocs/GUIDE.md#schedulingfor the full reference, the daemon state layout, and.photon-no-hostfor multi-host setups.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
