portel-dev

Photon — Development skill for Claude Code

Development community

Define intent once.

How to install Photon

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

What Photon does

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

Alternatives in Development

Mcporter — Call MCPs via TypeScript, masquerading as simple TypeScript API 4.1k ★
Auto — Smart router - Single entry point with natural language intent detection 2.8k ★
Open Agent SDK TypeScript — Agent-SDK without CLI dependencies, as an alternative to claude-agent-sdk, completely open source 2.6k ★

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:**