Named Agents

Named agents are persistent AI personas that remember your conversation history across sessions.

Creating an agent

create an agent named Steve, a senior Go engineer who prioritizes simplicity

Huginn creates a new agent with:

  • A name and custom system prompt
  • Persistent message history (last 20 messages, stored in Pebble KV)
  • An assigned model slot
  • A unique color in the TUI

Dispatching to agents

Use natural language to route requests:

have Steve review this auth middleware
ask Steve to refactor the database connection pool

Agent consultation

Agents can consult each other. If Steve needs a second opinion:

have Chris review Steve's refactor

Huginn routes the request, captures the exchange, and returns a unified response.

Persistence

Agent history is stored in ~/.huginn/agents.json. Memory persists across sessions — when you come back tomorrow, Steve remembers the last 20 exchanges.

Memory tiers

TierWhatDuration
Hot historyLast 20 messages in current sessionCurrent session
Warm summaryLLM-generated session summaryPersisted to Pebble
Delegation logLast 6 consultation exchangesPer agent pair