sajicode

v2.0.0

Published

5 days ago

Autonomous engineering organism — contract-first multi-agent team, 24/7 daemon, persistent memory, git-native safety, Guardian Swarm, MCP + A2A.

0High
0Medium
0Low

raheesahmed37

ai autonomous-agents multi-agent engineering cli langgraph mcp a2a devops security daemon

Install

npm install -g sajicode

cd your-project
sajicode

Or without a global install:

npx sajicode

Describe a task. The team plans, contracts, builds in parallel, verifies, and updates project memory.

Build a REST API for a task manager — Express, TypeScript, SQLite.
Add Zod validation, tests, security audit, Dockerfile, and CI.

Headless / CI:

sajicode build "Fix the failing auth tests and open a PR" --headless
sajicode fix-ci

Always-on:

sajicode daemon start
sajicode task add "Run standup and fix any red CI"

What SajiCode is

SajiCode is not a chat wrapper around one model.

It is an autonomous engineering system: a PM orchestrator, specialist leads with enforced territories, durable memory, git-native safety, a 24/7 daemon, and a defensive Guardian swarm — running on your machine, models, and infrastructure.

You  →  PM (research → plan → debate → decide)
           ↓  Phase 0 contracts (locked)
     Backend · Frontend · QA · Security · Deploy · …
           ↓  verify → ship → learn
     PROJECT.dna · skills · code graph · incident graph

Runs local / air-gapped (Ollama), cloud providers, CI, or serverless backends (Docker / Modal / Daytona).

Capabilities

Build like a real team

Dependency-aware task graph — independent leads run in parallel
Phase 0 contracts — APIs, types, and file ownership locked before code
Multi-file batch writes with snapshot rollback
Verification ladder — typecheck → tests → smoke → optional E2E
Research → debate → ADR for architecture judgment calls
fix-ci — pull the failed CI log and attempt a headless fix

Remember and improve

PROJECT.dna — architecture, decisions, unfinished work across sessions
Three-layer memory + semantic search
Experience replay — failures and wins injected into similar future work
Skill promotion — lessons distilled into portable SKILL.md files
Nightly memory consolidation via heartbeat

Understand large codebases

Tree-sitter AST code graph (TypeScript, JavaScript, Python, Go)
PageRank-ranked retrieval into .sajicode/codegraph.json
Optional prompt compression (config-gated)

Stay safe

Pre-write secret / injection scans
Shell risk scoring + human-in-the-loop approvals
PM blocked from writing implementation files
Session branches + sajicode revert / undo / snapshots
Usage & cost tracking from LangChain usage_metadata

Run 24/7

sajicode daemon start              # serve + heartbeat + task queue
sajicode daemon status
sajicode daemon deploy --backend docker   # or modal | daytona
sajicode serve                     # HTTP + channels + A2A card

Heartbeat evaluates .sajicode/HEARTBEAT.md (CI, deps, unfinished work) without you prompting.

Defend infrastructure

sajicode guardian scan
sajicode guardian incidents

Tiered response with consensus-gated containment. Security-officer persona available.

Connect to the ecosystem

MCP — attach databases, APIs, business tools (.sajicode/mcp.json)
A2A — publish /.well-known/agent.json; other agents can call build / audit / guardian
Plugins & skills — extend without forking
Personas — SOUL.md-style identity; business MCP templates (Shopify / Stripe / Gmail)
WhatsApp — send tasks from your phone

The team

A PM coordinates specialists. Each lead owns a territory and is blocked from writing outside it.

Plus domain specialists: Next.js, Python API, AI/RAG, MCP, 3D web, performance.

Contract-first (medium/large tasks):

Agents declare APIs, types, and files they will touch
PM rejects file-write conflicts and locks the registry
Leads implement in parallel against frozen contracts

CLI

No arguments → interactive REPL. Subcommands → CLI mode.

sajicode --help
sajicode --version

Core

Safety

Autonomy & ops

Extensibility

REPL slash commands

/init · /status · /help · /clear · /exit

Session flow

Every session starts the same way:

session state → memory index → PROJECT.dna → standup → stack patterns
→ classify → plan → (Phase 0 contracts) → parallel dispatch → verify → update DNA

Git isolation is automatic: session branch, before-tag, per-agent commits. One command reverts everything — or one agent.

Configuration

Project settings live in .sajicode/config.json.

Providers

sajicode -p anthropic -m claude-sonnet-4-6
sajicode -p openai -m gpt-4.1
sajicode -p google -m gemini-2.5-flash
sajicode -p ollama -m llama3.1:70b        # local / air-gapped
sajicode -p openrouter -m anthropic/claude-sonnet-4

ANTHROPIC_API_KEY=...
OPENAI_API_KEY=...
GOOGLE_API_KEY=...
TAVILY_API_KEY=...          # optional web search

Human-in-the-loop

{
  "humanInTheLoop": {
    "enabled": true,
    "tools": {
      "execute": { "allowedDecisions": ["approve", "edit", "reject"] }
    },
    "allowedCommands": ["npm run", "node ", "npx tsc"]
  }
}

Useful keys

Validate anytime:

sajicode config-doctor

Project layout

After init / first session:

your-project/
├── SAJICODE.md                 # generated project context
├── PROJECT.dna                 # persistent team brain
├── HEARTBEAT.md                # daemon checklist (optional)
└── .sajicode/
    ├── config.json
    ├── mcp.json
    ├── persona.md
    ├── codegraph.json          # tree-sitter knowledge graph
    ├── contracts.json
    ├── patterns.json
    ├── experiences.json
    ├── checkpoints.db          # durable LangGraph state
    ├── snapshots/
    └── transcripts/

Skills & plugins

23+ bundled skills (Agent Skills standard) — loaded on demand:

nodejs · nextjs · frontend-design · database · api-architect · testing · security · devops · ai-engineer · mobile-app · mcp-server · …

sajicode skill list
sajicode skill new my-domain
sajicode plugin search

Why SajiCode

MIT-licensed. npm-published. Built to be the harness — not another chatbot.

Full feature & tool reference: SajiCode_features.md.

Develop

git clone https://github.com/RaheesAhmed/SajiCode.git
cd SajiCode
npm install
npm run build
npm test
node dist/index.js

src/
├── agents/      # PM, leads, task graph, guardrails, debate
├── a2a/         # Agent-to-Agent server + client
├── guardian/    # SOC swarm & incidents
├── daemon/      # heartbeat, deploy backends, service install
├── context/     # tree-sitter code graph, compression
├── persona/     # identity packs
├── tasks/       # durable queue
├── memory/      # DNA, semantic memory, consolidation
├── tools/       # contracts, git session, verification, browser
├── channels/    # terminal, WhatsApp
├── cli/         # Commander CLI + renderer
└── server/      # HTTP serve + A2A mount