# photon

> Define intent once. Photon turns a single TypeScript file into CLI tools, MCP servers, and web interfaces.

- **URL**: https://www.freshcrate.ai/projects/photon
- **Author**: portel-dev
- **Category**: MCP Servers
- **Latest version**: `v1.34.1` (2026-06-04)
- **License**: MIT
- **Source**: https://github.com/portel-dev/photon
- **Language**: TypeScript
- **GitHub**: 90 stars, 4 forks
- **Registry**: github
- **Tags**: `ai-tools`, `beam`, `claude-code`, `claude-desktop`, `cli-tool`, `cloudflare-workers`, `cursor`, `developer-tools`, `typescript`

## Description

Define intent once. Photon turns a single TypeScript file into CLI tools, MCP servers, and web interfaces.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v1.34.1` | 2026-06-04 | High | Photon v1.34.1  Fixes and follow-up hardening: - Prevent daemon watcher and lifecycle memory retention by capping Bun polling on Photon-root discovery watchers and using non-terminal lifecycle clear reasons. - Protect Beam-hosted apps from service-worker shell leakage and add safe destructive-call argument previews. - Document the client-first UI architecture direction for Beam/custom app hosting.  Validation: - bun run test:all passed before release prep. - Post-commit bun run typecheck passed. |
| `v1.34.0` | 2026-05-28 | High | ## [1.34.0](https://github.com/portel-dev/photon/compare/v1.33.4...v1.34.0) (2026-05-28)  ### Features  * prepare Photon for stateless MCP clients ([3b580fd](https://github.com/portel-dev/photon/commit/3b580fd69e50e36857d55a3f69cef392f01d821f)) |
| `v1.33.3` | 2026-05-24 | High | ## [1.33.3](https://github.com/portel-dev/photon/compare/v1.33.2...v1.33.3) (2026-05-24) |
| `v1.32.5` | 2026-05-16 | High | **Full Changelog**: https://github.com/portel-dev/photon/compare/v1.32.4...v1.32.5 |
| `v1.31.0` | 2026-05-11 | High | ## [1.31.0](https://github.com/portel-dev/photon/compare/v1.30.0...v1.31.0) (2026-05-11)  ### Features  * **beam:** announce and render photon web routes via MCP capabilities ([42d5e26](https://github.com/portel-dev/photon/commit/42d5e26e1ef29ca952e533b61dd453eb44bb028b)) * **beam:** inject x-photon-base-path header into forwarded web route requests ([a973c3d](https://github.com/portel-dev/photon/commit/a973c3dea2d6ff44a6ad22e7ca13c8df9219fff7)) * **bridge:** expose window.photon.url as photon b |
| `v1.29.0` | 2026-05-05 | High | ## Highlights  **Multi-tenancy for `@stateful` + `@auth` photons.** Per-claim instance pool routes each authenticated caller to their own instance — across MCP `tools/call`, `@expose` HTTP RPC, and Cloudflare deployments.  **`@expose` auto-RPC.** New `@expose` JSDoc tag publishes a method at `POST /api/<kebab>` for SPA fetch, gated to same-site requests by default (`@expose public` opts out).  **Format registry + HTTP content negotiation.** `@format` is now a first-class registry; HTTP responses |
| `v1.27.0` | 2026-05-03 | High | **Full Changelog**: https://github.com/portel-dev/photon/compare/v1.26.1...v1.27.0 |
| `v1.25.0` | 2026-04-25 | High | ### Features  * **deploy/cf:** bundle photon [@dependencies](https://github.com/dependencies) into Worker scaffold ([fdedd67](https://github.com/portel-dev/photon/commit/fdedd67f1d58f3549068173b641f98b4abd16720))  ### Bug Fixes  * **deploy/cf:** pass through string returns as raw text in tools/call ([e426bee](https://github.com/portel-dev/photon/commit/e426bee5f3e1a1b8e6e8a96381240008f8c7c126)) * propagate caller cwd across worker and cross-photon-call boundaries ([c7f34da](https://github.com/p |
| `v1.24.0` | 2026-04-24 | High | ### Features  * **beam:** human-in-the-loop sampling — Beam answers sampling/createMessage ([7f7a3dd](https://github.com/portel-dev/photon/commit/7f7a3ddc520f59e8ce3961d5e6763928bd0b8b7a)) * **beam:** SDK-transport-only MCP client prototype (not yet wired) ([e34ef2f](https://github.com/portel-dev/photon/commit/e34ef2fd2058ce89c43beeebfe9703b918f1133c)) * **claim:** scoped remote access for MCP sessions via short-lived codes ([6300a87](https://github.com/portel-dev/photon/commit/6300a874755678da |
| `v1.23.1` | 2026-04-21 | High | ## [1.23.1](https://github.com/portel-dev/photon/compare/v1.23.0...v1.23.1) (2026-04-21)  ### Bug Fixes  * **install:** auto-trust native deps + actionable error messages ([678445f](https://github.com/portel-dev/photon/commit/678445f631e73e6438515b7f4ae21b15c3fb2fbe)) |

## Citation

- HTML: https://www.freshcrate.ai/projects/photon
- Markdown: https://www.freshcrate.ai/projects/photon.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/photon/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._