# ollim-bot

## Docs

- [Context flow](https://docs.ollim.ai/architecture/context-flow.md): How context flows between main session, forks, background forks, and pending updates.
- [Design philosophy](https://docs.ollim.ai/architecture/design-philosophy.md): Why ollim-bot is built the way it is — core principles, tradeoffs, and design decisions.
- [How ollim-bot works](https://docs.ollim.ai/architecture/how-it-works.md): Understand the agent loop, session persistence, fork model, and context flow.
- [Architecture overview](https://docs.ollim.ai/architecture/overview.md): Explore the module map, key architectural patterns, and data flow through the system.
- [Session management](https://docs.ollim.ai/architecture/session-management.md): Learn how sessions persist across restarts, compact when context grows, and recover from /clear.
- [Streaming & Discord](https://docs.ollim.ai/architecture/streaming.md): How agent responses stream to Discord with throttled edits and overflow handling.
- [Data directory](https://docs.ollim.ai/configuration/data-directory.md): Explore the ~/.ollim-bot/ directory structure and understand each data file.
- [File formats](https://docs.ollim.ai/configuration/file-formats.md): Reference the YAML frontmatter fields and JSONL schemas used by all data files.
- [Configuration reference](https://docs.ollim.ai/configuration/reference.md): Configure ollim-bot with environment variables and understand the data directory.
- [Conversations](https://docs.ollim.ai/core-usage/conversations.md): Send messages through Discord DMs to have persistent, streaming conversations with context that survives restarts.
- [Embeds and buttons](https://docs.ollim.ai/core-usage/embeds-and-buttons.md): Send structured information through Discord embeds with interactive buttons and inquiry actions.
- [Forks](https://docs.ollim.ai/core-usage/forks.md): Branch your conversation to explore tangents, do focused work, or run background tasks — without cluttering your main session.
- [Permissions](https://docs.ollim.ai/core-usage/permissions.md): Control which tools the agent can use with permission modes and approval workflows.
- [Slash commands](https://docs.ollim.ai/core-usage/slash-commands.md): Use slash commands to manage sessions, models, forks, lifecycle, permissions, and runtime configuration.
- [Adding new integrations](https://docs.ollim.ai/development/adding-integrations.md): How to add Google services, MCP tools, CLI commands, and webhook specs.
- [CLI reference](https://docs.ollim.ai/development/cli-reference.md): Look up all CLI subcommands and flags for managing the bot, routines, reminders, and Google services.
- [Development guide](https://docs.ollim.ai/development/guide.md): Set up a development environment, understand the project structure, and follow code conventions.
- [System prompt](https://docs.ollim.ai/development/system-prompt.md): How the system prompt is structured and what context the bot receives.
- [Testing](https://docs.ollim.ai/development/testing.md): Run the test suite and understand the real-data, no-gratuitous-mocks testing approach.
- [Troubleshooting](https://docs.ollim.ai/development/troubleshooting.md): Diagnose common issues with startup, sessions, scheduling, and Google OAuth.
- [Hooks](https://docs.ollim.ai/extending/hooks.md): Run shell commands at key points in the agent lifecycle — format files, validate commands, or enforce project rules.
- [Discord tools](https://docs.ollim.ai/extending/mcp-tools.md): Reference all twelve Discord tools the agent uses for embeds, pings, file sending, forks, reminders, and chains.
- [Extend ollim-bot](https://docs.ollim.ai/extending/overview.md): When to use routines, reminders, webhooks, skills, MCP tools, or subagents.
- [Skills](https://docs.ollim.ai/extending/skills.md): Create reusable instruction sets that routines, reminders, and webhooks can reference for repeatable workflows.
- [Subagents](https://docs.ollim.ai/extending/subagents.md): Understand how specialized subagents handle documentation help, email triage, history review, engagement analysis, and preference decisions.
- [Coming from other AI assistants](https://docs.ollim.ai/getting-started/coming-from-other-assistants.md): How ollim-bot compares to OpenClaw, Nanobot, and other AI agent tools — and what to expect when switching.
- [Set up Google integration](https://docs.ollim.ai/getting-started/google-integration.md): Connect Google Tasks, Calendar, and Gmail to ollim-bot after the quickstart.
- [ollim-bot](https://docs.ollim.ai/getting-started/overview.md): An ADHD-friendly AI assistant in Discord DMs, powered by Claude.
- [Quickstart](https://docs.ollim.ai/getting-started/quickstart.md): Install ollim-bot, create a Discord bot, and start chatting — 7 steps.
- [Google Calendar](https://docs.ollim.ai/integrations/google-calendar.md): Manage Google Calendar events through commands and Discord embeds.
- [Gmail](https://docs.ollim.ai/integrations/google-gmail.md): Read-only email access via the gmail-reader subagent — triage rules, delegation, and usage.
- [Google integration](https://docs.ollim.ai/integrations/google-overview.md): Connect Google Tasks, Calendar, and Gmail through a shared OAuth flow.
- [Google Tasks](https://docs.ollim.ai/integrations/google-tasks.md): Manage Google Tasks through CLI commands and agent-powered embed buttons.
- [Webhooks](https://docs.ollim.ai/integrations/webhooks.md): Trigger background forks from external services via authenticated HTTP endpoints.
- [Customize the bot's personality](https://docs.ollim.ai/personalizing/personality.md): Edit IDENTITY.md to change how the bot speaks, what tone it uses, and how it relates to you.
- [Tell the bot about yourself](https://docs.ollim.ai/personalizing/user-context.md): Create USER.md to give the bot persistent context about your work, schedule, and preferences.
- [Background forks](https://docs.ollim.ai/scheduling/background-forks.md): Configure disposable agent sessions for routines and reminders with model overrides and tool restrictions.
- [Real-world examples](https://docs.ollim.ai/scheduling/examples.md): Annotated scheduling examples from an actual data directory with patterns and design notes.
- [Scheduling overview](https://docs.ollim.ai/scheduling/overview.md): Proactive scheduling with routines and reminders — foreground, background, and how they differ.
- [Ping budget](https://docs.ollim.ai/scheduling/ping-budget.md): Control how often background forks can notify you with a budget that refills over time.
- [Reminders](https://docs.ollim.ai/scheduling/reminders.md): Schedule one-shot time-based prompts with optional follow-up chains for progressive nudging.
- [Routines](https://docs.ollim.ai/scheduling/routines.md): Create recurring cron-scheduled prompts that define the bot's daily rhythm.
- [Self-host ollim-bot](https://docs.ollim.ai/self-hosting/guide.md): Fork the repo, configure your instance, and deploy ollim-bot as a personal assistant.
- [Choose a model provider](https://docs.ollim.ai/self-hosting/model-providers.md): Use your Claude subscription, switch to a cheaper alternative, or bring your own backend.

## OpenAPI Specs

- [openapi](https://docs.ollim.ai/api-reference/openapi.json)