Open Source — MIT License

Unix-style agent orchestration for inherited codebases

NeoForge treats agents like Unix processes. Single-file scripts, JSON over pipes, a kubectl-like CLI, and pluggable discovery — so you can bolt multi-agent workflows onto the codebase you already have.

pip install neoforge Requires Python 3.11+ & uv
agentctl — neoforge
$ agentctl get agents

NAME             STATUS    DISCOVERY   RUNTIME
hotspot-finder   running   file        uv
drift-detector   idle      dns-srv     uv
test-runner      running   file        uv
doc-writer       idle      etcd        uv

$ agentctl describe hotspot-finder

agent:  hotspot-finder
file:   agents/hotspot_finder.py
input: {"repo": "string", "limit": "int"}
deps:   gitpython>=3.1, rich>=13  # PEP-723 inline

$ agentctl run hotspot-finder \
    --input '{"repo": ".", "limit": 10}' \
    | agentctl run doc-writer

hotspot-finder  doc-writer  piped 847 tokens
done  docs/hotspots.md written
Single-fileEach agent is one .py script
Zero DBJSON stdin/stdout, temp files only
3 discoveryfile → DNS SRV → etcd
MITFree forever, community-first
Core Design

Four principles that make it composable

Inspired by the Unix philosophy: small tools that do one thing and pipe cleanly into the next.

01 / AGENTS

Single-file agents

Every agent is a standalone Python script with an inline PEP-723 header declaring its name, version, and dependencies. No separate requirements.txt, no package to publish. Drop the file in agents/ and it's discoverable.

02 / DISCOVERY

Pluggable discovery

Agents find each other through a tiered resolver: file registry for local dev, DNS SRV for service-mesh environments, etcd for production clusters. Switch tiers per context without changing agent code.

03 / DATA FLOW

Zero database

Agents communicate over JSON on stdin/stdout. Bulk payloads spill to temp files. No shared database, no schema migrations, no ORM. Compose workflows with the pipe operator, just like shell commands.

04 / CLI

kubectl-like CLI

The agentctl CLI speaks kubectl verbs: get, describe, run, logs, exec, start, stop. If you've managed a Kubernetes cluster, the mental model is already in your head.

Built With NeoForge

Real products running on the toolkit

Production
Code Atlas

Claude Code session knowledge graphs

Code Atlas converts Claude Code sessions into a searchable knowledge graph. It runs entirely on NeoForge agents — hotspot finder, drift detector, session indexer — wired together with agentctl pipelines and YAML orchestration.

View Code Atlas