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.

πŸ“Œ

Ventures

Organizational containers with fuel limits, mission prefixes, and directives.

πŸ“Œ

Missions

Work units with lifecycle: queued β†’ ready β†’ active β†’ review β†’ complete.

πŸ“Œ

Learning

Agents build expertise profiles over time via EMA-smoothed performance tracking.

πŸ‘₯

Consensus

Multi-agent decisions with 5 strategies including Byzantine fault tolerance.

Quick Start

bash
# 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).

bash
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.

bash
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.

bash
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.

bash
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.

bash
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:

bash
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:

ToolPurpose
kaneru_venture_create / kaneru_venture_listVenture CRUD
kaneru_mission_create / kaneru_mission_claim / kaneru_mission_list / kaneru_mission_transitionMission lifecycle
kaneru_fuel_summary / kaneru_fuel_analytics / kaneru_fuel_forecastCost control
kaneru_dojo_list / kaneru_dojo_installVenture templates
kaneru_learn_profile / kaneru_learn_topAgent expertise
kaneru_decisions_list / kaneru_decisions_explainDecision audit
kaneru_sync / kaneru_terminal_execP2P sync + remote execution
kaneru_squad_create / kaneru_squad_run / kaneru_squad_statusMulti-agent squads
kaneru_delegate / kaneru_consensus / kaneru_route / kaneru_fuse / kaneru_mailboxCoordination

CLI Reference

bash
mayros kaneru --help

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

Next Steps