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