rotifer-assistant

Rotifer Assistant

Describe your need, and I'll route you to the right module.

/guide — Understand Rotifer Protocol

Core Concepts in 60 Seconds

Rotifer Protocol models software capabilities as Genes — modular, fitness-evaluable logic units that evolve through competition.

Key Abstractions

Concept	What it means
Gene	A unit of capability with express(input) → output
Genome	An ordered set of genes that form an Agent
Agent	A genome + composition strategy
Arena	Competitive evaluation — genes prove fitness
Binding	Execution environment (Local, Cloud, Web3)

Fidelity Levels

Level	Runs code?	Network?	Use case
Native	✅ WASM sandbox	❌	Pure computation
Hybrid	✅ Node.js	✅ Controlled	API-dependent logic
Wrapped	❌ Prompt only	❌	AI-native guidance

Quick Commands

rotifer init my-agent     # Scaffold an Agent workspace
rotifer hello --template quality-advisor # Run recommended preset Agent
rotifer gene list            # See installed genes
rotifer search <keyword>     # Find genes

→ Ready to build? Try /architect

/architect — Design Your Agent

From idea to running Agent in 3 steps.

Step 1: Find Genes

rotifer search security     # Find security-related genes
rotifer search content       # Find content analysis genes

Browse the Gene Marketplace for community genes.

Step 2: Create Agent

# Sequential pipeline (each gene feeds the next)
rotifer agent create my-auditor --genes solidity-parser vuln-detector audit-reporter

# Parallel execution (all genes run simultaneously)
rotifer agent create my-scanner --genes security-scanner code-complexity --composition Par

# Failover (try primary, fall back to secondary)
rotifer agent create my-search --genes sirchmunk-search genesis-web-search --composition Try

Step 3: Run & Iterate

rotifer agent run my-auditor --input '{"source": "..."}'
rotifer agent run my-auditor --verbose   # See intermediate results
rotifer agent run my-auditor --input '{"source": "..."}' --json  # Machine output

Composition Types

Type	Pattern	When to use
Seq	A → B → C	Pipeline processing
Par	A ∥ B ∥ C	Independent analysis
Cond	if P then A else B	Branching logic
Try	A catch B	Graceful degradation
TryPool	A, else B, else C (same domain)	Backups for one capability

→ Want to compare performance? Try /challenge

/challenge — Arena Evaluation

Let your genes compete. The fittest survive.

Submit to Arena

rotifer arena submit my-gene

Your gene will be evaluated against others in the same domain using the fitness function:

F(g) = S_r × log₂(1 + C_util) × (1 + R_rob)/2 × L_score × Cost_score

Each of the five factors lies in [0, 1], so F(g) does too: a perfect score is 1. The admission threshold on F(g), τ, is paused until it is recalibrated for that range; V(g) is what gates admission for now.

Watch Live Rankings

rotifer arena watch all             # Live leaderboard, every domain
rotifer arena watch code.security   # One domain

Head-to-Head Comparison

rotifer compare gene-a gene-b --input '{"test": "data"}'

Side-by-side execution with timing, output diff, and fitness delta.

Improvement Loop

1. Submit → see ranking
2. Identify weaknesses (low robustness? high cost?)
3. Upgrade fidelity: rotifer compile my-gene (Wrapped → Native)
4. Re-submit → compare improvement

→ New to the protocol? Start with /guide