Agent Configuration

The global agent config (agent.yaml) defines tools, LLM settings, session behavior, channels, workspace memory, and guardian settings for interactive chat mode.

Example

system_prompt: |
  You are a personal assistant. Be concise and helpful.
  Today is {date}.

tools:
  check_weather:
    executor: weather
    description: "Get current weather and forecast"
    parameters:
      location:
        type: string
        description: "City name or coordinates"
        required: true

  check_email:
    executor: gmail_readonly
    secrets: secrets/gmail.env.enc
    description: "Search Gmail for emails"
    parameters:
      query:
        type: string
        description: "Gmail search query"
        required: true

  # ... see agent.yaml for all tools (calendar, drive, iMessage, etc.)

llm:
  model: claude-sonnet-4-20250514
  max_tokens: 1024
  secrets: secrets/anthropic.env.enc

agent:
  max_turns: 15

session:
  sessions_dir: sessions
  max_history: 50
  summarize_on_trim: true

workspace:
  path: workspace
  timezone: "America/Denver"
  memory_days: 2
  memory_max_chars: 5000
  max_chars_per_file: 20000

channels:
  imessage:
    listen_to: "$PHONE"
    poll_interval: 3
  bluebubbles:
    server_url: "$BLUEBUBBLES_URL"
    password: "$BLUEBUBBLES_PASSWORD"
    listen_to:
      - "$PHONE"
    poll_interval: 3

Sessions

Sessions are stored as JSON files in sessions/ (gitignored) and persist conversation history across interactions. When summarize_on_trim is enabled, old messages are summarized before being trimmed.

Field	Description
`sessions_dir`	Directory to store session JSON files
`max_history`	Maximum number of messages to keep in history
`summarize_on_trim`	Use LLM to summarize old messages before removal

Workspace Memory

Workspace memory provides file-based memory across sessions:

workspace/memory/YYYY-MM-DD.md — Daily append-only logs written by the agent's remember tool
workspace/MEMORY.md — Curated long-term memory

Recent daily logs and long-term memory are injected into the system prompt automatically.

Field	Description
`path`	Root directory for workspace files
`timezone`	Timezone for date-stamped memory files
`memory_days`	Number of recent daily logs to include in prompt
`memory_max_chars`	Max characters from memory to inject into prompt
`max_chars_per_file`	Max characters to read from any single workspace file

Quiet Hours

Creel supports quiet hours to suppress proactive notifications during configured time periods (e.g., nighttime). Quiet hours only suppress outbound notifications — direct replies to user messages are never suppressed.

quiet_hours:
  enabled: true
  start: "22:00"  # 10 PM
  end: "08:00"    # 8 AM
  timezone: "America/Denver"

Guardian

See Guardian Security for the full guardian configuration reference.