Intelligence Pipeline

Myco runs an intelligence pipeline in the background that reads your captured sessions, extracts observations into the knowledge vault, maintains the graph, and keeps digest extracts fresh. It’s fully automatic — once providers are configured, you don’t need to trigger it manually. This page covers what it does, what tasks are available, how to configure providers, and how to schedule or disable parts of it.

What the pipeline produces

  • Spores — discrete observations extracted from session activity (gotchas, decisions, discoveries, trade-offs, bug fixes, and higher-order wisdom syntheses)
  • Entities and edges — a knowledge graph linking spores to components, concepts, and people
  • Session titles and summaries — human-readable labels for every captured session, generated from the actual work done
  • Digest extracts — pre-computed project context at three depth tiers (1500 / 5000 / 10000 tokens) that get injected at session start
  • Skill candidates — procedural patterns worth turning into skills (requires approval)

Every piece of this comes from the same source material: the prompts, tool calls, and assistant summaries captured by the symbiont hooks. Nothing is invented; everything traces back to a session.

Tasks

Fourteen tasks cover the full lifecycle. Most users only interact with vault-evolve (the default scheduled task) or vault-seed (a one-shot for brownfield repos) — the others are available for manual trigger or specialized workflows.

Intelligence

Task What it does
vault-evolve The complete pipeline. Runs on unprocessed batches, extracts spores, consolidates wisdom, refreshes digests. Scheduled by default.
vault-seed One-shot manual seeding for brownfield codebases — explores the repo with filesystem + grep tools and creates the initial spore set and digest.
title-summary Generates or updates a session title and summary. Runs automatically after each session turn.
extract-only Spore extraction without the digest work. Useful for catching up after a long gap.
review-session Deep end-to-end processing of a single session. Trigger from the session detail page.
digest-only Regenerate digest extracts from the current vault state.
supersession-sweep Find and resolve duplicate or contradictory spores.

Cortex injection

Task What it does
cortex-instructions Generate the per-project instructions block that ships with the session-start digest.
cortex-prompt-builder Build the per-prompt spore injection payload.

Canopy

Task What it does
canopy-describe Generate the optional one-line LLM descriptions for Canopy entries.
canopy-map Synthesize and refresh the project map.

See Canopy for what these produce.

Skill lifecycle

Task What it does
skill-survey Discovers procedural skill candidates from vault knowledge. Runs periodically.
skill-generate Generates a validated SKILL.md file from one approved candidate. Runs when approved candidates exist.
skill-evolve Monitors active skills for knowledge drift and rewrites stale content.

See the Skills docs for the full skill lifecycle.

Configuring providers

Every task can use a different LLM provider. Configuration is all in myco.yaml under the agent: key, with a precedence hierarchy from global defaults to per-phase overrides.

The simplest setup

One provider for everything:

agent:
  provider:
    type: anthropic
    model: claude-sonnet-4-6

That’s it. Every task will use Claude Sonnet via the Anthropic API (or your Claude Code OAuth if you have it).

Per-task overrides

A common pattern is using a fast local model for lightweight tasks (title generation) and a capable cloud model for the heavy work:

agent:
  provider:                          # Global default
    type: anthropic
    model: claude-sonnet-4-6
  tasks:
    title-summary:
      provider:                      # Local model for titles
        type: ollama
        model: granite4:small-h
        context_length: 32768

Supported providers

Provider Type string Notes
Anthropic anthropic Uses your Claude Code OAuth or ANTHROPIC_API_KEY
Ollama ollama Local models; specify base_url if not on the default port
LM Studio lmstudio Local models via OpenAI-compatible API

For local providers, set a context_length that matches the model’s capabilities — Myco uses it to configure the runtime correctly.

Per-phase overrides (advanced)

For phased tasks like vault-evolve, you can override the provider for individual phases. Useful for mixing cloud quality and local cost:

agent:
  tasks:
    vault-evolve:
      phases:
        extract:
          provider:
            type: anthropic           # Quality for extraction
            model: claude-sonnet-4-6
        consolidate:
          provider:
            type: ollama              # Local for consolidation
            model: llama3.2

Scheduling

Each task runs on its own schedule. The defaults ship with the built-in task definitions; you override them in myco.yaml.

agent:
  scheduled_tasks_enabled: true      # Master switch for all scheduled tasks
  event_tasks_enabled: true          # Master switch for event-driven tasks (title-summary)
  tasks:
    vault-evolve:
      schedule:
        enabled: true
        intervalSeconds: 300         # Check for unprocessed batches every 5 min
    skill-survey:
      schedule:
        enabled: true
        intervalSeconds: 600         # Every 10 min when candidates might exist

For capture-only projects, leave the project capability toggles off. Myco still captures sessions and keeps search available, while heavier intelligence work such as Vault Evolution, Canopy mapping, and skill lifecycle tasks stays off. Canopy context injection follows the Canopy capability for each project. See Grove Management for the user-facing guide to project capabilities.

Tasks only run when Myco is active or recently active. Background work pauses when the developer has stepped away.

Triggering tasks manually

From the dashboard’s Operations page you can kick off any task on demand — useful for catching up after a gap, re-running after a provider change, or testing a new task configuration.

From the CLI:

myco agent run vault-evolve      # Run the default pipeline now
myco agent run skill-survey            # Survey for new skill candidates

Custom tasks

Drop a YAML task definition into .myco/tasks/*.yaml and it’ll load alongside the built-ins on restart. Custom tasks have access to the same tool set and scheduling options as built-ins. The built-in task definitions are in packages/myco/src/agent/definitions/tasks/ if you want reference examples.

Monitoring and troubleshooting

Command What it shows
myco stats Service status, active sessions, database stats
myco doctor Health check — data, providers, agents, service
myco logs Tail service logs

The dashboard’s Logs page gives you real-time filtered output if you’d rather read it in the UI. Agent run details (which phases ran, what they produced) live on the Operations page.