Poppet documentation

Poppet runs on your computer and uses your chosen model provider. Follow the setup guide to send your first message, then pick a guide below for what you want to do next.

Start here#

1. Get started to install Poppet, connect a provider, and send a message.
2. Use chat to hold a conversation, resume a session, and find earlier answers.

Terminal chat works without a background worker. For setup problems, see troubleshooting. To look up a command, use the command reference.

Use Poppet#

• Notes: find, read, and save files in a directory you choose.
• Memory: keep preferences and facts you ask Poppet to save.
• Projects: save instructions, facts, and a list of notes for related chats and tasks.
• Skills: select a reusable procedure for a chat or task.

Schedule work#

• Scheduled tasks: schedule a prompt and manage its next run.
• Monitoring: check a source regularly and report changes to a specific value.
• Worker: keep scheduling and messaging running, in a terminal or at macOS login.

Connect services#

• Messaging: choose Discord, Telegram, or WhatsApp and connect your account.
• Read and search the web: summarize a public page or enable optional web search with Brave or Kagi.
• Browser automation: read rendered websites and request specific interactions.
• MCP tools: choose which tools Poppet can use from trusted local programs.

Reference#

• Providers: compare ChatGPT, OpenRouter, and OpenCode Go and connect one.
• Configuration: save settings, understand overrides, and set limits.
• Command line: look up commands and options.
• Storage: inspect local records and understand recovery.
• Troubleshooting: check configuration, provider access, workers, and missing tools.

For the app’s source code, see the app repository.