{"_id":"@andrewsispoidis/colony","_rev":"6-1eac8a8a846c558ca9254669fdcce47d","name":"@andrewsispoidis/colony","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@andrewsispoidis/colony","version":"0.1.0","license":"Apache-2.0","_id":"@andrewsispoidis/colony@0.1.0","maintainers":[{"name":"andrewsispoidis","email":"asispoidis@me.com"}],"bin":{"colony":"dist/index.js"},"dist":{"shasum":"9383913d31830f51a72647c2343c5cf4fa1c4021","tarball":"https://registry.npmjs.org/@andrewsispoidis/colony/-/colony-0.1.0.tgz","fileCount":32,"integrity":"sha512-xeV43T73p2nP/Jr+PS6wrNpeeKIqc40nRJiUeII/xz2u7knbZ+sQH//UDrAwuo+IRXZhkP/diW1qqAer8a/YSQ==","signatures":[{"sig":"MEQCIBNtIALUrEBLvcHMyzAk7kJL0iMMeIDbc9ZNf1kifYdlAiBqm7h3hiOKtmYyg4qLdAa/QaV4dKPl2DH5eEjJXKez4Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":49278},"type":"module","gitHead":"a973581cd3edffaf8f63065b7836269c69ec763a","scripts":{"dev":"tsx src/index.ts","build":"tsc"},"_npmUser":{"name":"andrewsispoidis","email":"asispoidis@me.com"},"_npmVersion":"11.11.0","description":"**The universal agent composition standard — install, compose, and run AI agents from a community registry. No framework required.**","directories":{},"_nodeVersion":"25.8.1","dependencies":{"ora":"^8.1.1","chalk":"^5.3.0","js-yaml":"^4.1.0","inquirer":"^9.3.7","commander":"^12.1.0","@anthropic-ai/sdk":"^0.39.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","typescript":"^5.6.3","@types/node":"^22.0.0","@types/js-yaml":"^4.0.9","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/colony_0.1.0_1774905765585_0.3910550461475395","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@andrewsispoidis/colony","version":"0.1.1","license":"Apache-2.0","_id":"@andrewsispoidis/colony@0.1.1","maintainers":[{"name":"andrewsispoidis","email":"asispoidis@me.com"}],"bin":{"colony":"dist/index.js"},"dist":{"shasum":"ea8bb8adb9478f02a392c22d88a4b726dfa29f35","tarball":"https://registry.npmjs.org/@andrewsispoidis/colony/-/colony-0.1.1.tgz","fileCount":32,"integrity":"sha512-rcLeMNVgJ3MTOhZLpTPqd+Zf8PCodGOjWtW+1xNgMrUMxkes5MjjSUshxwVwRE8x6kD7DReeVLJ1j/jo67Hx8Q==","signatures":[{"sig":"MEUCIGo87YToT3MRx7sAcvXNmzM3kon4w1+dyjIUZIKK/SNvAiEA/oKXDTocB4W2dlfpl/M5Xpw+s75gl5A4sA2Wcimv3Dg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":49489},"type":"module","gitHead":"93b4c987378cdc7f37662a13698b31f967ad7dd8","scripts":{"dev":"tsx src/index.ts","build":"tsc && node -e \"const fs=require('fs');const f='dist/index.js';let c=fs.readFileSync(f,'utf8');if(!c.startsWith('#!'))fs.writeFileSync(f,'#!/usr/bin/env node\\n'+c);\" && chmod +x dist/index.js"},"_npmUser":{"name":"andrewsispoidis","email":"asispoidis@me.com"},"_npmVersion":"11.11.0","description":"**The universal agent composition standard — install, compose, and run AI agents from a community registry. No framework required.**","directories":{},"_nodeVersion":"25.8.1","dependencies":{"ora":"^8.1.1","chalk":"^5.3.0","js-yaml":"^4.1.0","inquirer":"^9.3.7","commander":"^12.1.0","@anthropic-ai/sdk":"^0.39.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","typescript":"^5.6.3","@types/node":"^22.0.0","@types/js-yaml":"^4.0.9","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/colony_0.1.1_1774905859916_0.21461736655929142","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@andrewsispoidis/colony","version":"0.1.2","license":"Apache-2.0","_id":"@andrewsispoidis/colony@0.1.2","maintainers":[{"name":"andrewsispoidis","email":"asispoidis@me.com"}],"bin":{"colony":"dist/index.js"},"dist":{"shasum":"6a04e7910a03b6e3a88bb62b15339323472ed17b","tarball":"https://registry.npmjs.org/@andrewsispoidis/colony/-/colony-0.1.2.tgz","fileCount":33,"integrity":"sha512-8+lom6lGpP0qMTQW4nCbpYIVqwiRLTJZJPii8aAs/FgugmGTCyjZzNIxIY2GDX6jrZQSiuiG1OjQdDmaOhOI7A==","signatures":[{"sig":"MEQCIHi4hqpBONmzhqzvn4IFmpQwo22V//e9+Y3IoQiqmE2XAiBbye/n+adnBmrzL1w9yuVzasC4DdaRneZbYJHnnlerBA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64501},"type":"module","gitHead":"7374e4c71127677bf3715e500e4814ef4428e327","scripts":{"dev":"tsx src/index.ts","build":"tsc && node -e \"const fs=require('fs');const f='dist/index.js';let c=fs.readFileSync(f,'utf8');if(!c.startsWith('#!'))fs.writeFileSync(f,'#!/usr/bin/env node\\n'+c);\" && chmod +x dist/index.js"},"_npmUser":{"name":"andrewsispoidis","email":"asispoidis@me.com"},"_npmVersion":"11.11.0","description":"**The universal agent composition standard — install, compose, and run AI agents from a community registry. No framework required.**","directories":{},"_nodeVersion":"25.8.1","dependencies":{"ora":"^8.1.1","chalk":"^5.3.0","js-yaml":"^4.1.0","inquirer":"^9.3.7","commander":"^12.1.0","@anthropic-ai/sdk":"^0.39.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","typescript":"^5.6.3","@types/node":"^22.0.0","@types/js-yaml":"^4.0.9","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/colony_0.1.2_1774905910764_0.4173040173285285","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@andrewsispoidis/colony","version":"0.1.3","license":"Apache-2.0","_id":"@andrewsispoidis/colony@0.1.3","maintainers":[{"name":"andrewsispoidis","email":"asispoidis@me.com"}],"bin":{"colony":"dist/index.js"},"dist":{"shasum":"3583de2c8ba4ead8355a84057f53b5a92cab7fc9","tarball":"https://registry.npmjs.org/@andrewsispoidis/colony/-/colony-0.1.3.tgz","fileCount":32,"integrity":"sha512-RfBh79Bh5CZq2ANp9kXCR7HgodSVXARi9d99iaO0GAAySi7eU25MTWaexZH6VEaL0t5ScHINc5jHymYYO4APfg==","signatures":[{"sig":"MEUCIQDMnV7ZmayEa6xcAETr3UjEQ4zwMhPZgLMYuLz5WYVVJAIgaCaN8piul83cg+Ppfekra6YWSSCCc0DGfj1u4xPqw2M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":49520},"type":"module","gitHead":"e558217abd2e2c2f1299009a551e6aeaa1a46d6d","scripts":{"dev":"tsx src/index.ts","build":"tsc && node -e \"const fs=require('fs');const f='dist/index.js';let c=fs.readFileSync(f,'utf8');if(!c.startsWith('#!'))fs.writeFileSync(f,'#!/usr/bin/env node\\n'+c);\" && chmod +x dist/index.js"},"_npmUser":{"name":"andrewsispoidis","email":"asispoidis@me.com"},"_npmVersion":"11.11.0","description":"**The universal agent composition standard — install, compose, and run AI agents from a community registry. No framework required.**","directories":{},"_nodeVersion":"25.8.1","dependencies":{"ora":"^8.1.1","chalk":"^5.3.0","js-yaml":"^4.1.0","inquirer":"^9.3.7","commander":"^12.1.0","@anthropic-ai/sdk":"^0.39.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","typescript":"^5.6.3","@types/node":"^22.0.0","@types/js-yaml":"^4.0.9","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/colony_0.1.3_1774907459739_0.2894769806408677","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@andrewsispoidis/colony","version":"0.1.4","license":"Apache-2.0","_id":"@andrewsispoidis/colony@0.1.4","maintainers":[{"name":"andrewsispoidis","email":"asispoidis@me.com"}],"bin":{"colony":"dist/index.js"},"dist":{"shasum":"342745223a3fc328f609f2ee4375e50dc3c6f4d4","tarball":"https://registry.npmjs.org/@andrewsispoidis/colony/-/colony-0.1.4.tgz","fileCount":32,"integrity":"sha512-vx2neKXHJvhDMYXJ5OsRvR/tSlke561j5mQfxi5L7JppFDQxgLZAVVTjLDcgmw+t1RbjkhcQD/pXO3cqOp7xKw==","signatures":[{"sig":"MEQCIDdu2GFw/CKDSeuDboWvYGjWAArny87Ja3Y3L2Hp91hYAiB6YgC9x8JosWzdl3GQ6Qt80G+7YweSfi0Q6EFSo0hijA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":49505},"type":"module","gitHead":"a72587991700b0cc5cd4f234189659cf2c3697f4","scripts":{"dev":"tsx src/index.ts","build":"tsc && node -e \"const fs=require('fs');const f='dist/index.js';let c=fs.readFileSync(f,'utf8');if(!c.startsWith('#!'))fs.writeFileSync(f,'#!/usr/bin/env node\\n'+c);\" && chmod +x dist/index.js"},"_npmUser":{"name":"andrewsispoidis","email":"asispoidis@me.com"},"_npmVersion":"11.11.0","description":"**The universal agent composition standard — install, compose, and run AI agents from a community registry. No framework required.**","directories":{},"_nodeVersion":"25.8.1","dependencies":{"ora":"^8.1.1","chalk":"^5.3.0","js-yaml":"^4.1.0","inquirer":"^9.3.7","commander":"^12.1.0","@anthropic-ai/sdk":"^0.39.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","typescript":"^5.6.3","@types/node":"^22.0.0","@types/js-yaml":"^4.0.9","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/colony_0.1.4_1774908774622_0.9251360729448688","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@andrewsispoidis/colony","version":"0.2.0","license":"Apache-2.0","type":"module","bin":{"colony":"dist/index.js"},"dependencies":{"@anthropic-ai/sdk":"^0.39.0","bcryptjs":"^3.0.3","better-sqlite3":"^12.8.0","chalk":"^5.3.0","commander":"^12.1.0","inquirer":"^9.3.7","js-yaml":"^4.1.0","jsonwebtoken":"^9.0.3","openai":"^6.33.0","ora":"^8.1.1"},"devDependencies":{"@types/bcryptjs":"^2.4.6","@types/better-sqlite3":"^7.6.13","@types/inquirer":"^9.0.7","@types/js-yaml":"^4.0.9","@types/jsonwebtoken":"^9.0.10","@types/node":"^22.0.0","tsx":"^4.19.2","typescript":"^5.6.3"},"scripts":{"build":"tsc && node -e \"const fs=require('fs');const f='dist/index.js';let c=fs.readFileSync(f,'utf8');if(!c.startsWith('#!'))fs.writeFileSync(f,'#!/usr/bin/env node\\n'+c);\" && chmod +x dist/index.js","dev":"tsx src/index.ts"},"gitHead":"0670534d513784381c18b4069b6dca5fab91831a","_id":"@andrewsispoidis/colony@0.2.0","description":"**The universal agent composition standard — install, compose, and run AI agents from a community registry. No framework required.**","_nodeVersion":"25.8.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-hBqyyc+s9TlUYtpozkyLurnwcr1SvBW6oIGSOQbvDnUDfiGPWmrqpPqXxevJ/XC0+45bRAT6MXXkTFkUdtmOnw==","shasum":"fdeaa7086af698af22f2aab7a228ccfa7025a64e","tarball":"https://registry.npmjs.org/@andrewsispoidis/colony/-/colony-0.2.0.tgz","fileCount":38,"unpackedSize":76781,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIC5zFH4Q1HflD7+BcBsZKquMpbySjYNIXTPP8bMeymSPAiEAyoOZ0BrYHKF0qMdAKjgCeUyMwH97D2s/ZMdRdPjVkmU="}]},"_npmUser":{"name":"andrewsispoidis","email":"asispoidis@me.com"},"directories":{},"maintainers":[{"name":"andrewsispoidis","email":"asispoidis@me.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/colony_0.2.0_1774913807795_0.642152256891773"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-30T21:22:45.488Z","modified":"2026-03-30T23:36:48.073Z","0.1.0":"2026-03-30T21:22:45.708Z","0.1.1":"2026-03-30T21:24:20.057Z","0.1.2":"2026-03-30T21:25:10.908Z","0.1.3":"2026-03-30T21:50:59.898Z","0.1.4":"2026-03-30T22:12:54.772Z","0.2.0":"2026-03-30T23:36:47.948Z"},"license":"Apache-2.0","description":"**The universal agent composition standard — install, compose, and run AI agents from a community registry. No framework required.**","maintainers":[{"name":"andrewsispoidis","email":"asispoidis@me.com"}],"readme":"# Colony\n\n**The universal agent composition standard — install, compose, and run AI agents from a community registry. No framework required.**\n\n---\n\n## Part 1: Vision\n\nColony is an open standard for defining, sharing, and composing AI agents. It provides the missing infrastructure layer between foundation models and production agent workflows — letting anyone install community agents, wire them into multi-step workflows, and run them with a single command.\n\nColony is to AI agents what npm is to JavaScript packages: a universal registry and composition layer that makes the ecosystem interoperable.\n\n### Core Principles\n\n- **Agents are portable.** An agent defined once runs anywhere Colony runs.\n- **Composition over frameworks.** Wire any agents together without buying into a monolithic framework.\n- **Community-first.** A shared registry means agents get better collectively.\n- **YAML-native.** Workflows and agent specs are human-readable YAML — no code required to compose.\n- **Model-agnostic by design.** Agents declare which models they need; Colony handles the rest.\n\n---\n\n## Part 2: Agent Specification\n\nAn agent is defined by a `colony.agent.yaml` file:\n\n```yaml\nname: \"@scope/agent-name\"\nversion: \"1.0.0\"\ndescription: \"What this agent does\"\nauthor: \"author-name\"\n\nmodel: \"claude-opus-4-5-20250514\"\n\nsystem_prompt: |\n  You are a specialized agent that...\n\ninput_schema:\n  type: object\n  properties:\n    topic:\n      type: string\n      description: \"The topic to process\"\n  required:\n    - topic\n\noutput_schema:\n  type: object\n  properties:\n    result:\n      type: string\n\ntools:\n  - web_search\n  - file_read\n\nconfig:\n  max_tokens: 4096\n  temperature: 0.7\n```\n\n### Required Fields\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `name` | string | Scoped package name (`@scope/name`) |\n| `version` | string | Semantic version |\n| `description` | string | Human-readable description |\n| `system_prompt` | string | The agent's system prompt |\n\n### Optional Fields\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `author` | string | Agent author |\n| `model` | string | Preferred model identifier |\n| `input_schema` | object | JSON Schema for expected input |\n| `output_schema` | object | JSON Schema for output format |\n| `tools` | string[] | Tool capabilities the agent needs |\n| `config` | object | Model configuration overrides |\n\n---\n\n## Part 3: Workflow Specification\n\nWorkflows compose agents into multi-step pipelines using `colony.yaml`:\n\n```yaml\nname: research-and-write\nversion: \"0.1.0\"\ndescription: \"Research a topic and produce a polished article\"\n\nsteps:\n  - agent: \"@community/research-agent\"\n    input: \"Research the history and current state of quantum computing\"\n\n  - agent: \"@community/writer-agent\"\n    # Receives research output as input automatically\n\n  - agent: \"@community/reviewer-agent\"\n    # Reviews the written article\n\noutput:\n  save_to: \"article.md\"\n  format: \"markdown\"\n```\n\n### How Steps Execute\n\n1. Steps run **sequentially** in the order defined.\n2. Each step's output becomes the next step's input (unless `input` is explicitly set).\n3. A **working memory** carries context across steps — each agent can see what previous agents produced.\n4. If any step fails, the workflow halts and reports the error.\n\n### Step Configuration\n\nEach step supports:\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `agent` | string | Agent name or local path (`./my-agent`) |\n| `input` | string | Explicit input (overrides previous output) |\n| `config` | object | Per-step config overrides |\n\n---\n\n## Part 4: Registry\n\nThe Colony Registry is the community hub for sharing agents. Agents are published and installed using scoped names:\n\n```bash\n# Install from the registry\ncolony install @community/research-agent\n\n# Install from a specific scope\ncolony install @myorg/custom-agent\n\n# Publish your agent\ncolony publish\n```\n\n### Registry Architecture\n\n- Agents are stored at `~/.colony/agents/<scope>/<name>/`\n- Each installed agent contains its `colony.agent.yaml` manifest\n- The registry supports scoped namespaces for organizations and communities\n- Version resolution follows semver conventions\n\n### Bundled Agents\n\nColony ships with five community agents available immediately:\n\n| Agent | Description |\n|-------|-------------|\n| `@community/research-agent` | Deep research and synthesis |\n| `@community/writer-agent` | Polished content creation |\n| `@community/reviewer-agent` | Quality review and feedback |\n| `@community/summarizer-agent` | Concise summarization |\n| `@community/analyst-agent` | Data analysis and insights |\n\n---\n\n## Part 5: Working Memory\n\nColony's working memory system provides context continuity across workflow steps.\n\n### How It Works\n\n- Each workflow execution creates a **WorkingMemory** instance\n- As each agent completes, its output is written to memory with metadata\n- Subsequent agents receive the accumulated memory as context\n- Memory entries include: key, value, timestamp, source agent, and step number\n\n### Memory Context Format\n\n```\n<working_memory>\n[step_1_output]: Research findings on quantum computing... (from: @community/research-agent)\n[step_2_output]: Draft article on quantum computing... (from: @community/writer-agent)\n</working_memory>\n```\n\nThis allows downstream agents to reference any previous step's output, not just the immediately preceding one.\n\n---\n\n## Part 6: CLI Reference\n\n### Commands\n\n```\ncolony setup              Interactive configuration setup\ncolony config get <key>   Get a config value\ncolony config set <k> <v> Set a config value\ncolony config list        List all config values\ncolony init               Create colony.yaml in current directory\ncolony install <agent>    Install an agent from the registry\ncolony list               List installed agents\ncolony run                Run the workflow defined in colony.yaml\ncolony run --agent <name> Run a single agent directly\ncolony run --verbose      Show streamed token output\ncolony agent init         Scaffold a new agent interactively\ncolony agent test         Test an agent from colony.agent.yaml\ncolony publish            Publish an agent to the registry\n```\n\n### Global Options\n\n```\n--help     Show help for any command\n--version  Show Colony version\n```\n\n### Configuration\n\nColony stores configuration at `~/.colony/config.json`. The API key can also be set via the `ANTHROPIC_API_KEY` environment variable (takes precedence over config).\n\n---\n\n## Part 7: Local Development\n\n### Creating an Agent\n\n```bash\n# Scaffold a new agent\ncolony agent init\n\n# This creates colony.agent.yaml with interactive prompts\n# Edit the system_prompt to define your agent's behavior\n\n# Test your agent\ncolony agent test\ncolony agent test --input \"Custom test input\"\n```\n\n### Local Agent References\n\nWorkflows can reference local agents by path:\n\n```yaml\nsteps:\n  - agent: \"./my-local-agent\"\n    input: \"Process this data\"\n```\n\nColony looks for `colony.agent.yaml` inside the referenced directory.\n\n### Development Workflow\n\n1. `colony agent init` — scaffold your agent\n2. Edit `colony.agent.yaml` — refine the system prompt\n3. `colony agent test` — verify behavior\n4. `colony publish` — share with the community\n\n---\n\n## Part 8: Composition Patterns\n\n### Sequential Pipeline\n\nThe most common pattern — each agent builds on the previous:\n\n```yaml\nsteps:\n  - agent: \"@community/research-agent\"\n    input: \"Investigate renewable energy trends\"\n  - agent: \"@community/analyst-agent\"\n  - agent: \"@community/writer-agent\"\n  - agent: \"@community/reviewer-agent\"\n```\n\n### Specialist Delegation\n\nUse specific agents for specific subtasks:\n\n```yaml\nsteps:\n  - agent: \"@community/research-agent\"\n    input: \"Gather data on market trends in AI\"\n  - agent: \"@community/analyst-agent\"\n    input: \"Analyze the research for investment opportunities\"\n  - agent: \"@community/summarizer-agent\"\n    input: \"Create an executive summary\"\n```\n\n### Quality Assurance Loop\n\nResearch, write, review:\n\n```yaml\nsteps:\n  - agent: \"@community/research-agent\"\n    input: \"Deep dive into container orchestration\"\n  - agent: \"@community/writer-agent\"\n  - agent: \"@community/reviewer-agent\"\n  - agent: \"@community/writer-agent\"\n    # Rewrites based on review feedback\n```\n\n---\n\n## Part 9: Architecture\n\n### System Overview\n\n```\n┌─────────────┐     ┌──────────────┐     ┌────────────┐\n│  colony.yaml │────▶│ Orchestrator │────▶│  Executor   │\n│  (workflow)  │     │  (runtime)   │     │ (API calls) │\n└─────────────┘     └──────┬───────┘     └────────────┘\n                           │\n                    ┌──────┴───────┐\n                    │Working Memory│\n                    └──────────────┘\n```\n\n### Components\n\n- **CLI** (`src/index.ts`) — Commander-based CLI that wires all commands\n- **Config** (`src/config/`) — Manages `~/.colony/config.json` and API keys\n- **Registry** (`src/registry/`) — Agent resolution, installation, and bundled agents\n- **Runtime** — Three modules:\n  - **Executor** (`src/runtime/executor.ts`) — Calls Anthropic API with streaming\n  - **Orchestrator** (`src/runtime/orchestrator.ts`) — Runs multi-step workflows\n  - **Memory** (`src/runtime/memory.ts`) — Working memory across steps\n- **Commands** (`src/commands/`) — Individual CLI command implementations\n\n### Agent Resolution Order\n\n1. Local path (`./` or absolute path)\n2. Bundled agents (built into Colony)\n3. Installed agents (`~/.colony/agents/`)\n\n---\n\n## Part 10: Roadmap\n\n### v0.1.0 (Current)\n\n- [x] CLI with all core commands\n- [x] Sequential workflow orchestration\n- [x] Working memory system\n- [x] 5 bundled community agents\n- [x] Agent scaffolding and testing\n- [x] Local agent development\n\n### v0.2.0 (Planned)\n\n- [ ] Live Colony Registry for publishing and installing agents\n- [ ] Parallel step execution\n- [ ] Conditional branching in workflows\n- [ ] Agent-to-agent communication channels\n- [ ] Workflow variables and templating\n\n### v0.3.0 (Future)\n\n- [ ] Multi-model support (OpenAI, Google, local models)\n- [ ] Tool plugins (web search, file I/O, API calls)\n- [ ] Workflow visualization and debugging UI\n- [ ] Agent versioning and dependency resolution\n- [ ] Hosted workflow execution\n\n### Long-Term Vision\n\nColony aims to be the **universal standard** for agent composition. Just as containers standardized application deployment and package managers standardized code sharing, Colony standardizes how AI agents are defined, shared, and composed.\n\nThe end state: a world where thousands of specialized agents are available in the registry, composable into arbitrarily complex workflows with a few lines of YAML, and executable anywhere with `colony run`.\n\n---\n\n## Getting Started\n\n```bash\n# Install Colony\nnpm install -g colony\n\n# Set up your API key\ncolony setup\n\n# Install some agents\ncolony install @community/research-agent\ncolony install @community/writer-agent\n\n# Create a workflow\ncolony init\n\n# Run it\ncolony run\n```\n\n---\n\n## License\n\nApache-2.0\n","readmeFilename":"README.md"}