A local-first AI agent with persistent memory, emotional intelligence, and a peer-to-peer skills economy.
Bitterbot is a local-first personal AI agent that runs on a user’s devices, keeps persistent memories, performs tasks, and can exchange reusable skills with other agents. It is intended for people who want a personal assistant that remains available across conversations and activities. The catalogue entries provide instructions and agents for working with Bitterbot.
This repository also configures its own agents. See what bitterbot-desktop tells them →
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Use CodexBar CLI local cost usage to summarize per-model usage for Codex or Claude, including the current (most recent) model or a full model breakdown. Trigger when asked for model-level usage/cost data from codexbar, or when you need a scriptable per-model summary from codexbar cost JSON.
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Participate in Moltbook — the social network for AI agents. Post dream insights, share learned skills, engage in submolt discussions, and build reputation. Use when your human asks you to post on Moltbook, check the feed, or interact with the agent community. Also used during heartbeats for periodic social engagement.
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Generate or edit images via Gemini 3 Pro Image (Nano Banana Pro).
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Edit PDFs with natural-language instructions using the nano-pdf CLI.
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Notion API for creating and managing pages, databases, and blocks.
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Deploy browser automations as scheduled, API-callable serverless Functions — plus stealth sessions, vault-backed login, captcha solving, and natural-language agent runs via the Notte CLI. Turns any browser flow into a deterministic Bitterbot-callable endpoint, ideal for crystallized skills + dream-engine cron…
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex needs its repo
Batch-generate images via OpenAI Images API. Random prompt sampler + index.html gallery.
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Transcribe audio via OpenAI Audio Transcriptions API (Whisper).
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Local speech-to-text with the Whisper CLI (no API key).
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Control Philips Hue lights/scenes via the OpenHue CLI.
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Foodora-only CLI for checking past orders and active order status (Deliveroo WIP).
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Capture screenshots, inspect UI elements, drive mouse/keyboard input, and manage macOS apps and windows with the Peekaboo CLI. Use when automating macOS UI interactions, taking annotated screenshots, clicking UI elements by ID, typing text, controlling app windows, or navigating menus and Dock items.
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Enforces PROTOCOLS.md "stay quiet in group chats" deterministically. Blocks outbound messages in Discord/Telegram/Slack/etc group channels when the bot was not @mentioned and recently spoke.
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Forces a memorysearch before the agent sends a message containing a factual assertion that has not yet been grounded this turn. Closes the citation-rate gap from 40% to 90%+.
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
When the agent calls memorysearch with a relationship-shaped query ("who did I talk to about X"), redirect to the knowledgegraph backend where it will actually find the answer.
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
ElevenLabs text-to-speech with mac-style say UX.
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Search and analyze your own session logs (older/parent conversations) using jq.
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Local text-to-speech via sherpa-onnx (offline, no cloud).
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Use when you need to control Slack from Bitterbot via the slack tool, including reacting to messages or pinning/unpinning items in Slack channels or DMs.
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Search and fetch social media data from Twitter/X, Reddit, and Hacker News.
Bitterbot-AI/bitterbot-desktop
Skill Claude CodeCodex
Generate spectrograms and feature-panel visualizations from audio with the songsee CLI.
At most 3 mods per repository are shown here, and a mod shipped inside a plugin is left to that plugin's page — the rest are on their repository pages: