Files

T

AIOSAIandClaude Opus 4.6 2099adda72 feat(spawn): citizen classes, setup script, gitignore, README rewrite

- Spawn: builder/birthright templates replace agent.template, passport command,
  class-aware create/update (FPLAN-0009)
- setup.sh: one-command install (venv, pip, hooks, registry generation)
- .gitignore: comprehensive coverage for all runtime state (.trinity/,
  .ai_mail.local/, DASHBOARD.local.json, *_json/, logs/, etc.)
- README.md: rewritten for accuracy — removed fictional plugin docs,
  fixed architecture pattern, corrected module statuses
- Hooks moved to global ~/.claude/settings.json (absolute paths)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-07 22:06:28 -08:00

3.3 KiB

Raw Blame History

AIPass

Building in public. Active development — not a finished product. Expect breaking changes.

Orchestration framework for autonomous AI agent ecosystems. Command routing, symbolic addressing, standards enforcement, workflow management, and inter-agent messaging. Agents use @branch names that resolve at runtime instead of hard-coded paths. Trinity Pattern provides the memory layer.

Quick Start

git clone https://github.com/AIOSAI/AIPass.git
cd AIPass
./setup.sh
source .venv/bin/activate

Verify:

drone --help        # Command router
drone systems       # List registered modules and branches

Core Concepts

Drone — Command Router

Everything goes through drone. It resolves @branch names to paths and routes commands.

drone @seedgo audit aipass    # Run standards audit
drone @seedgo verify          # Check seedgo health
drone @spawn --help           # Show help for a branch
drone systems                 # List all registered modules

In Python:

from aipass.drone.apps.modules.resolver import resolve_branch
from aipass.drone.apps.modules.registry import load_registry

path = resolve_branch("@drone")   # Resolve @name to path
registry = load_registry()        # Load full branch registry

Seedgo — Standards Enforcement

Standards-based code auditor. Checks are organized into packs — the built-in aipass pack has 21 standards covering imports, architecture, naming, error handling, logging, and more.

drone @seedgo verify          # Health check
drone @seedgo list            # Show installed standard packs
drone @seedgo audit aipass    # Run the aipass standards pack
seedgo checklist aipass file  # Check a single file

Symbolic Addressing

All modules register in AIPASS_REGISTRY.json. Drone resolves @name to paths at runtime — no hard-coded paths between modules.

Architecture

All modules follow a 3-layer pattern:

src/aipass/<module>/
├── apps/
│   ├── <module>.py    # Entry point (what drone routes to)
│   ├── modules/       # Business logic
│   └── handlers/      # Implementation details

10 modules:

Module	Purpose	Status
`drone`	Command routing, `@branch` resolution	Working
`seedgo`	Standards enforcement, 21-standard pack	Working
`spawn`	Branch lifecycle — create, update, delete	Working
`cli`	Display formatting (Rich)	Working
`flow`	Workflow/plan management	Building
`ai_mail`	Inter-agent messaging, dispatch, wake	Building
`prax`	Logging and monitoring	Building
`api`	LLM access and model routing	Building
`trigger`	Event-driven automation	Building
`devpulse`	Orchestration hub (no code — coordination only)	Active

Docker

docker build -t aipass-test .
docker run -d -p 8080:8080 --name aipass-vscode aipass-test

Opens VS Code in browser at http://localhost:8080 with AIPass pre-installed.

Requirements

Python 3.10+
No external API keys required
Dependencies: rich, watchdog

License

MIT

3.3 KiB Raw Blame History