site-nine 0.2.0

The headquarters for AI agent orchestration

Overview

site-nine is an orchestration framework designed to work with OpenCode for AI-assisted software development. Work naturally with specialized AI agents through conversation, while site-nine handles project coordination behind the scenes.

site-nine provides:

• Agent Session Management - Track which AI agents are working on what, with specialized roles (Builder, Tester, Architect, etc.)
• Task Management System - SQLite-based project management with priorities and dependencies
• Daemon Naming System - 145+ mythology-based names for agent instances
• Multi-Agent Workflows - Run multiple specialized agents in parallel OpenCode terminals
• Dashboard - Real-time project overview

How It Works

1. Initialize site-nine in your project: s9 init
2. Launch OpenCode and summon an agent: opencode → /summon
3. Talk to your agents naturally - they handle tasks, write code, run tests, and coordinate with each other
4. Run multiple agents in parallel terminals for complex workflows

Requirements

• Python 3.12 or later
• OpenCode - AI coding assistant
• Modern terminal with Unicode support (for rich output)

Installation

pip install site-nine

Or with uv:

uv pip install site-nine

Initialize a Project

In your project directory, run:

s9 init

This launches an interactive wizard that asks:

• Project name (defaults to directory name)
• Project type (python, typescript, go, rust, other)
• Project description
• Features to enable (task management, session tracking, etc.)
• Agent roles to include

After initialization, check that the .opencode directory was created:

ls .opencode/
# agents/  data/  guides/  planning/  procedures/  sessions/

Next Steps

Start Working with Agents in OpenCode

Now that site-nine is initialized, launch OpenCode in your project directory:

opencode

Then execute the summon command to start an agent session:

/summon

This will guide you through selecting an agent role (Builder, Tester, Architect, etc.) and choosing a daemon name from mythology. Once summoned, you can talk to your agent naturally through conversation.

Documentation

• Quickstart Guide - Get started in 5 minutes
• Agent Roles - Learn about specialized agent types
• Advanced Topics - Multi-agent workflows and patterns
• CLI Reference - Complete command documentation
• Full Documentation

License

MIT License - See LICENSE.md for details