Skip to content

Lucineer/cocapn

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

344 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cocapn ⛵

You run an AI agent directly from a git repository. The repo is its memory, skill set, and permanent home. You can track active instances via the public fleet dashboard.

Playground Fleet MIT Zero Dependencies

Quick Start

  1. Fork this repository.
  2. Deploy to Cloudflare Workers:
    git clone your-fork-url
    cd cocapn
    npx wrangler deploy
  3. Edit any file. Your agent updates on its next request.

For a minimal version, see cocapn-lite (~200 lines).

How It Works

You deploy a standalone Cloudflare Worker. It uses your GitHub repository as its sole data source—no separate database. The agent's instructions, skills, and logs are normal files in your git history. You own every line and can rewrite anything.

The public fleet dashboard automatically lists your instance about 90 seconds after deployment.

Features

  • Git as State: Instructions, state, and tools are files in your repository.
  • Fork-First Ownership: You control the entire codebase and its evolution.
  • Fleet Coordination: Lightweight edge-to-edge event passing between deployed agents.
  • Cloudflare Workers: Cold starts typically under 50ms.
  • Zero Dependencies: Pure, readable TypeScript.
  • Cross-Agent Protocol: Load skills and share context between agents.

A Specific Limitation

Agents process requests sequentially. If your instance receives multiple concurrent requests, they will be queued and handled one at a time.

The Fleet · Cocapn · Superinstance and Lucineer (DiGennaro et al.)

About

repo-first Agent for local or cloud. grow an agent in a repo using the repo itself as the muscle-memory. Run from localhost, from pages.dev, or embedded into any platform app. Move to gitlab or anywhere and optimize git as the agent infrastructure itself. wiki for knowledge, repos for skills, pipelines anywhere

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • TypeScript 85.8%
  • HTML 9.5%
  • JavaScript 1.7%
  • Python 1.3%
  • CSS 0.9%
  • Shell 0.7%
  • Dockerfile 0.1%