Taogen

Ideas take root. Agents grow.

Taogen starts from one minimal terminal harness, unfolds into multi-model intelligence and orchestrated subagents, and lets many workflows arise in the spirit of “道生一，一生二，二生三，三生万物.”

Quick Start

1. Install Pi

curl -fsSL https://pi.dev/install.sh | bash

Or via npm:

npm i -g @earendil-works/pi-coding-agent

2. Clone this repo

git clone <repo-url> ~/.pi

3. Set up API keys

cp .env.sample .env

Open .env and fill in your keys. You need at least one provider key to get started:

Provider	Used for
OpenAI (Codex)	Default model (GPT-5.5)
DeepSeek	Scout subagent (DeepSeek V4 Pro)
Anthropic	Alternative provider
Google Gemini	Alternative provider
MiniMax	Alternative provider
OpenRouter	Multi-model gateway

Then authenticate inside Pi:

pi
# inside Pi, run:  /auth

4. Install dependencies

cd ~/.pi/agent/npm && npm install && cd ../extensions/flow-title && npm install

5. Run

pi

You should see the green TAOGEN ASCII banner. You're good to go.

What's Inside

~/.pi/
├── .env.sample              # API key template
├── agent/
│   ├── settings.json        # Model, theme, and package config
│   ├── extensions/           # Custom TypeScript extensions
│   │   └── flow-title/      # ASCII banner header
│   │       ├── index.ts
│   │       └── package.json
│   ├── prompts/              # Slash-command shortcuts (.md)
│   ├── themes/               # Custom color themes
│   │   └── everforest.json
│   └── npm/                  # Installed packages
│       └── (pi-subagents)
└── coms-net/                 # Inter-instance communication

Configuration

agent/settings.json is the main config file:

{
  "defaultProvider": "openai-codex",
  "defaultModel": "gpt-5.5",
  "defaultThinkingLevel": "xhigh",
  "packages": ["npm:pi-subagents"],
  "subagents": {
    "agentOverrides": {
      "scout": {
        "model": "deepseek/deepseek-v4-pro",
        "thinking": "high",
        "fallbackModels": ["openai-codex/gpt-5.5"]
      }
    }
  }
}

• Default model: GPT-5.5 via OpenAI Codex with extended thinking
• Scout agent: Uses DeepSeek V4 Pro for fast reconnaissance, falls back to GPT-5.5
• Theme: Everforest (dark green/earth tones)
• Subagents: scout, planner, worker, reviewer, and more via pi-subagents

Customization

What	Where	Docs
Add a model/provider	agent/settings.json	Models
Write an extension	agent/extensions/*.ts	Extensions
Add a slash command	agent/prompts/*.md	Prompts
Change the theme	agent/themes/*.json	Themes

Documentation

• Documentation index
• ADR-0001: Edu Training Multi-Agent Workflow Architecture
• Edu Training Upgrade To-Do List
• Edu Training Agent Team Specification
• Edu Training Workflow Chains
• Edu Training Artifact Contracts

License

MIT