What is Kaneru?

Kaneru is Mayros's multi-agent venture management system. It lets you create AI ventures — organizations of agents with missions, chain of command, fuel budgets, and learning profiles. Every entity is stored in Cortex as semantic triples, every state change is DAG-committed for full auditability.

Quick Start

bashCopy
# Install a pre-built venture template
mayros kaneru dojo install --template security-audit --name "My Security Team"

# Or create step by step
mayros kaneru venture create --name "Acme" --prefix ACM --directive "Ship fast" --fuel-limit 10000
mayros kaneru mission create --venture <id> --title "Audit auth module" --priority critical

Or use the Setup Wizard in the web portal: open mayros dashboard → Ventures tab → New Venture.

Architecture

Venture (organization)
├── Project (group of missions)
│   └── Mission (work unit)
│       ├── Comments (discussion thread)
│       ├── Fuel Events (cost tracking)
│       └── Learning Profile (agent expertise)
├── Directive (strategic → objective → task tree)
├── Chain of Command (agent escalation hierarchy)
└── Pulse Schedule (agent wake triggers)

All stored as Cortex RDF triples — queryable by any agent, DAG-auditable, time-travelable.

Key Concepts

Ventures

A venture is the top-level organizational container. It has a name, directive, fuel limit, and a unique prefix for mission identifiers (e.g., SEC-1, OPS-42).

bashCopy
mayros kaneru venture create --name "Security Audit" --prefix SEC --directive "Ship secure code" --fuel-limit 10000
mayros kaneru venture list

Missions

Missions are the work units agents execute. They follow a strict state machine:

queued → ready → active → review → complete
                   ↓
               abandoned

Agents claim missions atomically (optimistic concurrency). Only the claiming run can transition the mission.

bashCopy
mayros kaneru mission create --venture <id> --title "Audit auth module" --priority critical
mayros kaneru mission claim --mission <id> --agent scanner --run run-001
mayros kaneru mission transition --mission <id> --status complete --run run-001

Learning Profiles

After each mission, agents update their expertise profile (domain × task type). The routing system blends Q-learning values with expertise scores to assign missions to the best agent automatically.

bashCopy
mayros kaneru learn profile --agent scanner
# typescript:security-scan — expertise: 92%, success: 95%, missions: 47

mayros kaneru learn top --domain typescript --task-type security-scan

Fuel Control

Fuel is Mayros's cost tracking system. Every LLM call is recorded as a fuel event with provider, model, tokens, and cost in integer cents. No monthly reset needed — spend is computed on-the-fly from event history.

bashCopy
mayros kaneru fuel summary --venture <id>
mayros kaneru fuel analytics --venture <id> --period weekly
mayros kaneru fuel forecast --venture <id>

Decision History

Every consensus decision is persisted with full reasoning — question, votes, strategy, outcome, participants, and confidence. Queryable and explainable.

bashCopy
mayros kaneru decisions list --venture <id>
mayros kaneru decisions explain --decision <id>

Dojo Templates

Pre-built venture templates that install a complete setup in one command:

bashCopy
mayros kaneru dojo list
# security-audit, content-pipeline, devops-squad

mayros kaneru dojo install --template security-audit --name "My Security Team"
# Creates venture + 3 agents + escalation hierarchy + 6 directives

Templates can also be downloaded from the Skill Hub marketplace.

Web Portal

The portal at http://localhost:18789 includes Kaneru-specific tabs:

• Ventures — venture table, mission kanban, chain tree, fuel bars
• Kaneru — squads, Q-learning router, squad builder
• Canvas — interactive A2UI surfaces (overview, missions, chain, fuel)
• Setup Wizard — 4-step guided venture creation
• Command Bar (Ctrl+/) — Spotlight-style overlay with venture context and voice input

MCP Tools

24 Kaneru tools are exposed via MCP, accessible from Claude Desktop, Claude Code, Cursor, Cline, or any MCP client:

CLI Reference

bashCopy
mayros kaneru --help

18 subcommand groups with 40+ commands. See the Kaneru CLI reference for the full list.

Next Steps

• Ventures & Missions — detailed guide
• Learning & Routing — how agents improve
• DAG Audit Trail — immutable action history
• MCP Tools Reference — all 24 tools