Puruto

The repository IS the application

What is Puruto?

Puruto is a development framework for building agentic applications. It defines a standard for packaging apps so that any code agent can understand and run them — without additional configuration.

The core idea: the repository is the application. The agent reads the repo, knows who it is, what it can do, and how to behave.

Open standard

Built on the SKILL.md format, adopted by Claude Code, Gemini CLI, Codex and Windsurf since December 2025. Write once, run on any agent.

Local ecosystem

Everything lives in ~/purutos/. Puruto itself does not depend on the cloud (but the agent/runner you use may require network access or a paid plan). Your data, your machine, your rules.

Generator included

One command creates a complete, functional Puruto repo: CLAUDE.md, agent.md, 4 base skills, .env.example and README — all working from day one.

Composable

Connect Purutos to each other with agentic IPC. puruto-data as a data vault, puruto-telegram as a mobile connector.

Quick start

# 1. Clone the framework
git clone https://github.com/pepetox/puruto.git && cd puruto

# 2. Install generator dependency
pip install jinja2

# 3. Open in your agent and initialize the ecosystem
/init

# 4. Create your first app
/puruto-generator

If you are not using a compatible agent yet, you can start with CLI:

python3 .claude/skills/puruto-generator/scripts/generate.py \
  --name puruto-demo \
  --description "Example Puruto"

Ecosystem Purutos

puruto-data Private data vault. All Purutos read and write here.

puruto-telegram Mobile connector with deterministic routing by active channel.

puruto-cron Local async job scheduler with SQLite and notifications.

puruto-gateway Unified REST API to expose Puruto base commands.

プルト (Puruto) — Japanese phonetic adaptation of Pluto. Small, but with its own ecosystem.