Argus

A Git-native agentic organization framework where a human CEO directs proactive role agents that create tasks, produce artifacts, request approvals, and help build software products. Codename: Argus.

Vision

Proactive AI is not multi-agent chat. It is a local-first company workspace where agents participate proactively in software development.

• The human is the CEO.
• Agents have roles, responsibilities, permissions, and wake triggers.
• Memory lives in version-controlled Markdown artifacts.
• Tasks are Markdown files with structured frontmatter.
• Human approvals flow through an inbox.
• Events are appended to an audit log.
• Codex is the default AI provider for v0.

Documentation

Using argus:

• 📘 User Guide — install, the 60-second tour, full CLI reference, how cycles work, troubleshooting. Read this first if you're a human driving argus.
• 🤖 Agent Guide — the same material distilled for AI coding assistants (pi, Claude Code, Cursor, Codex) helping a human use argus.

Contributing to argus: see AGENTS.md and the design docs below — that's a different audience with different rules.

Current status

@trycedar/[email protected] — dogfood release. The CLI binary is argus. Workspaces from 0.1.x auto-migrate on first run.

Design docs:

• docs/prd-v0.md
• docs/technical-design-v0.md
• docs/architecture-v0.md
• docs/self-hosting-and-release.md
• docs/agent-system-and-harness.md
• docs/pi-project-template-evaluation.md
• docs/decisions/ — ADRs

Dogfood workspace

This repo includes the initial Proactive AI workspace structure:

.argus/
company/
tasks/
artifacts/
comments/
inbox/
events/
agents/

The workspace tracks the development of Proactive AI itself.

Development harness

This repo uses pi-project-template conventions:

• AGENTS.md — hard rules for agents
• docs/memory/ — short/long-term shared memory
• docs/plans/ — active plans
• docs/records/ — completed records
• docs/decisions/ — ADRs
• docs/log.md — append-only change log
• .github/workflows/codex.yml — Codex issue pickup workflow
• scripts/validate.sh — merge validation contract

Install

From source:

pnpm install
pnpm build
pnpm link --global
argus --help

After npm publication:

npm install -g @trycedar/argus
argus --help

Quickstart

npm install -g @trycedar/argus
argus init my-company
cd my-company
git init && git add -A && git commit -m "init: argus workspace"

argus ceo "Build a CRM for solo financial advisors. Find the smallest MVP."
argus run --no-ai                # free probe — what would wake?
argus run --once --max-agents 1  # one real cycle, single agent
argus tasks; argus inbox
git log --oneline

For the full CLI reference, the cycle / wake / validate / freshness / cost model, and troubleshooting, see the User Guide.

Validation

./scripts/validate.sh --check