portel-dev

Photon

Name: Photon
Author: portel-dev

Development community

SOURCE https://github.com/portel-dev/photon

Description

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

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

[![npm version](https://img.shields.io/npm/v/@portel/photon?color=cb3837&label=npm)](https://www.npmjs.com/package/@portel/photon) [![npm downloads](https://img.shields.io/npm/dm/@portel/photon?color=cb3837)](https://www.npmjs.com/package/@portel/photon) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/portel-dev/photon/blob/main/LICENSE) [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178c6.svg)](https://www.typescriptlang.org) [![Node](https://img.shields.io/badge/node-%3E%3D20-43853d.svg)](https://nodejs.org) [![MCP](https://img.shields.io/badge/MCP-compatible-7c3aed.svg)](https://modelcontextprotocol.io) [![Docs](https://img.shields.io/badge/docs-photon-blue)](https://photon.portel.dev/)

One TypeScript capability becomes the whole agent stack.

Photon is the fastest way to turn a small, verified TypeScript method into something humans can operate and agents can trust. Write the capability once; Photon derives the interfaces, contracts, and runtime behavior around it:

MCP server for Claude, ChatGPT, Cursor, and agents
Embedded app UI for chat clients that support MCP app resources
CLI tool for scripts, demos, and automation
Beam web interface for humans
Web routes, schedules, webhooks, retries, state, and audit history when the capability grows into a production workflow

Photon is free and open source software released under the [MIT license](./LICENSE). Full documentation lives at [photon.portel.dev](https://photon.portel.dev/).

Related Portel project: [NCP](https://portel-dev.github.io/ncp/) gives agents one natural MCP interface to discover and run tools across a whole tool ecosystem. Photon builds reliable agent-facing capabilities; NCP helps agents find and use them alongside every other MCP.

**Try it in two minutes:**