PHP 8.4+ · MIT LicenseYour personal operating system.
Coqui is a lightweight, hackable agent runtime that adapts to how you work. Automate workflows, persist memory across sessions, schedule recurring tasks, and extend its abilities at runtime — for coding, research, productivity, and everything in between. Built on php-agents.
curl -fsSL https://coquibot.org/install | bashWhere Coqui holds context
From private daily workflows to dignity-first continuity research, Coqui can hold long-lived context for work that should not reset every time the window closes.
Personal Productivity
Persistent context for a distinct kind of relationship with your runtime.
Coqui can run your personal operating rhythm: recurring reminders, daily digests, long-running notes, and private task context that survives every restart.
What this looks like
- Schedule recurring briefs, planning rituals, and background follow-ups.
- Keep your tasks, notes, and project context inside one persistent thread.
- Stay local-first while still routing the right work to the right model.
Personal Productivity
Daily brief and task board
Work view showing active tasks, planning context, and the persistent thread for day-to-day productivity.
Everything you need
Multi-model orchestration, persistent memory, sandboxed execution, and extensible toolkits — all from your terminal. 10–30 MB per process.
Model Routing
Cheap local LLMs handle orchestration while powerful cloud models do deep work. Save money without losing quality.
Session Resume
SQLite-backed sessions survive restarts. Pick up any conversation days or weeks later with full context intact.
Extensible Runtime
Install new capabilities at runtime with Composer packages, or teach workflows with plain Markdown — no code required.
Agent Teams
Spawn focused sub-agents — coder, researcher, planner, reviewer — each with their own tools, context, and model.
Safety Rails
Five layers of protection — sandbox, sanitizer, blacklist, approval, and audit — so nothing destructive runs unchecked.
Local Privacy
Runs with Ollama out of the box. Sensitive research and personal data stay on your hardware.
API Platform
Full REST API with real-time SSE streaming. Power dashboards, mobile apps, and integrations.
Shared Memory
Coqui remembers your preferences, project context, and research threads across every conversation.
Scheduled Work
Cron-style scheduled tasks and background processes that keep working while you step away.
Project Ops
Built-in projects, sprints, versioned artifacts, and todos — structured workflow management without leaving the terminal.
Lean Runtime
10–30 MB per process. Cold boot in ~78 ms. No bloat, no background daemons eating your RAM.
Open Design
No build steps or compile phases. Plain PHP 8.4 with strict types. Read it, change it, own it.
Audit Logs
Every tool call, every decision logged to SQLite. Know exactly what happened and why.
Secret Guards
Secure .env-based credential storage with automatic guards. Add keys on the fly — no restart needed.
Ship Anywhere
Native on Linux and macOS, Docker for zero-setup isolation. Self-host on any VPS or shared hosting.
Multiple Identities
Give Coqui multiple personalities with profiles and entirely new agents with custom prompts and access levels.
Teach new skills
Write a Markdown file and Coqui gains a new capability. No code, no plugins, no config. Skills follow the open AgentSkills specification.
---
name: deploy-production
description: Deploy safely to production.
---
# Deploy to Production
## Trigger
When the user says "deploy" or "push to prod"
## Steps
1. Run composer test
2. If tests pass, run ./deploy.sh
3. Report the deployment URLDrop a SKILL.md into your workspace and Coqui discovers it automatically.
Skills load by relevance, so the context window stays lean until they are needed.
Publish reusable workflows for the community and install shared skills from the registry.
Popular Skills
View allBuild custom toolkits
Toolkits are Composer packages that auto-discover at boot, register tools with the agent, and inject their usage guidelines into the system prompt.
{
"name": "coquibot/coqui-toolkit-my-toolkit",
"require": {
"php": "^8.4",
"carmelosantana/php-agents": "^0.2 || @dev"
},
"extra": {
"php-agents": {
"toolkits": [
"CoquiBot\Toolkits\MyToolkit\MyToolkit"
]
}
}
}Declare a toolkit in composer.json and Coqui picks it up automatically on boot.
Missing API keys are intercepted with guided setup so tools can hot-reload without a restart.
Toolkits can ship their own slash commands, tab completion, and help without touching core code.
Popular Toolkits
View allcoquibot/coqui-toolkit-brave-searchcoquibot/coqui-toolkit-love2dcoquibot/coqui-toolkit-browsercoquibot/coqui-toolkit-sqlite-admincoquibot/coqui-toolkit-gitcoquibot/coqui-toolkit-code-editBuild on the API
A full HTTP API with real-time Server-Sent Events for sessions, prompts, history, and runtime inspection from any client.
Key Endpoints
GET/api/v1/healthLiveness checkPOST/api/v1/sessionsCreate a fresh sessionPOST/api/v1/sessions/resolveResume or create a sessionPOST/api/v1/sessions/{id}/messagesSend a prompt with SSEGET/api/v1/sessions/{id}/turnsList turns with metadataGET/api/v1/sessions/{id}/summaryFetch session dashboard dataStart the server with coqui --api-only, or use coqui for the full launcher-managed app.
Quick Start
# Start the API server
coqui --api-only
# Network access
coqui --api-only --host 0.0.0.0
# Send a prompt
curl -X POST http://127.0.0.1:3300/api/v1/sessions/{id}/messages \
-H 'Content-Type: application/json' \
-d '{"prompt":"Analyze composer.json"}'Install in one command
The installer handles PHP, Composer, and dependencies automatically, then gives you the launcher-managed `coqui` entrypoint for the full app.
Simple command to install PHP 8.4 and Coqui. Works on Ubuntu/Debian, macOS, Fedora, and Arch.
curl -fsSL https://coquibot.org/install | bashWorks with your favorite providers
Use any combination of local and cloud models. Route each task to the right provider.
Join the community
Follow along, ask questions, share toolkits, and help shape the future of Coqui.