CasAbot Configuration

CasAbot Configuration

This manual explains CasAbot's directory structure, configuration file schema, and provider management methods.

---

1. Directory Structure

All CasAbot data is stored under ~/casabot/.

~/casabot/
├── casabot.json          # All settings (providers, models, etc.)
├── skills/               # Skills directory (contains SKILL.md)
│   ├── agent/            # Agent creation & management
│   ├── config/           # Configuration management (this document)
│   ├── chat/             # Conversation management
│   ├── service/          # System service registration
│   ├── memory/           # Memory (memo) management
│   └── subskills/        # Sub-agent skill attachment and management
├── workspaces/           # Per-agent workspaces
│   └── <agent-name>/     # Individual agent working directory
│       └── output/       # Agent output results
├── history/              # Full conversation logs (raw logs, JSON)
└── memory/               # Agent-written memos (.md)

Role of Each Directory

Directory	Description	Format
casabot.json	Provider settings, active model, and all configuration	JSON
skills/	Skill manuals referenced by the base agent	SKILL.md (YAML + Markdown)
workspaces/	Working spaces mounted to sub-agent containers	Free format
history/	Auto-saved conversation logs (read-only)	JSON
memory/	Memos written directly by agents	Markdown

2. casabot.json Schema

Full structure of the configuration file.

{
  "providers": [
    {
      "name": "provider name (unique identifier)",
      "type": "openai | anthropic | huggingface | openrouter | custom-openai | custom-anthropic",
      "apiKey": "API key",
      "endpoint": "custom endpoint URL (optional, required for custom-* types)",
      "model": "model name",
      "isDefault": true
    }
  ],
  "activeProvider": "name of the currently active provider",
  "baseModel": "base model name"
}