{"id":48765485,"url":"https://github.com/questpie/autopilot","last_synced_at":"2026-04-13T07:49:50.766Z","repository":{"id":345986657,"uuid":"1188194322","full_name":"questpie/autopilot","owner":"questpie","description":"Autonomous AI dev team that lives in your repo — define agents, assign roles, let them collaborate through a filesystem-native workflow engine.                                                      ","archived":false,"fork":false,"pushed_at":"2026-04-10T11:15:47.000Z","size":5076,"stargazers_count":6,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-13T07:49:49.131Z","etag":null,"topics":["agent-sdk","ai-agents","ai-orchestration","autonomous-coding","claude","codex","developer-tools","devops-automation","open-source","workflow-engine"],"latest_commit_sha":null,"homepage":"https://autopilot.questpie.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/questpie.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/security.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-21T18:37:53.000Z","updated_at":"2026-04-10T11:15:52.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/questpie/autopilot","commit_stats":null,"previous_names":["questpie/questpie-autopilot"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/questpie/autopilot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/questpie%2Fautopilot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/questpie%2Fautopilot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/questpie%2Fautopilot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/questpie%2Fautopilot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/questpie","download_url":"https://codeload.github.com/questpie/autopilot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/questpie%2Fautopilot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31744404,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T06:26:45.479Z","status":"ssl_error","status_checked_at":"2026-04-13T06:26:44.645Z","response_time":93,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-sdk","ai-agents","ai-orchestration","autonomous-coding","claude","codex","developer-tools","devops-automation","open-source","workflow-engine"],"created_at":"2026-04-13T07:49:46.625Z","updated_at":"2026-04-13T07:49:50.752Z","avatar_url":"https://github.com/questpie.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# QUESTPIE Autopilot\n\n\u003e AI-native company operating system. Your company is a container. Your employees are agents.\n\n[![License: MIT](https://img.shields.io/badge/license-MIT-B700FF?style=flat-square)](LICENSE)\n[![TypeScript](https://img.shields.io/badge/TypeScript-strict-B700FF?style=flat-square)]()\n[![Bun](https://img.shields.io/badge/runtime-Bun-B700FF?style=flat-square)](https://bun.sh)\n[![Beta](https://img.shields.io/badge/status-BETA-B700FF?style=flat-square)]()\n\n\u003c/div\u003e\n\n---\n\n## Quick Start\n\n### One-line install (VPS/server)\n```bash\ncurl -fsSL https://raw.githubusercontent.com/questpie/autopilot/main/install.sh | bash\n```\n\n### Docker\n```bash\ngit clone https://github.com/questpie/autopilot\ncd autopilot\ncp .env.example .env\ndocker compose up\n```\n\nOpen `http://localhost:3000` for the dashboard. The local Caddy proxy keeps browser auth and API calls same-origin.\n\n\u003e **Authentication:**\n\u003e Set your OpenRouter API key in `.env` (`OPENROUTER_API_KEY=sk-or-...`)\n\u003e or run `autopilot provider set openrouter --api-key \u003ckey\u003e`.\n\u003e One key gives you access to all models (Anthropic, OpenAI, Google, etc.).\n\n### bunx (local dev)\n```bash\nbunx @questpie/autopilot init my-company\ncd my-company\n\n# Set your OpenRouter API key\nautopilot provider set openrouter --api-key sk-or-...\n\nbunx @questpie/autopilot start\n```\n\n---\n\n## What Happens\n\n```bash\n$ autopilot ask \"Build a pricing page with Stripe\"\n\nCEO Agent decomposing intent...\n\n  task-050: Scope requirements      → Sam (strategist)\n  task-051: Design UI               → Jordan (design)\n  task-052: Implement with Stripe   → Max (developer)\n  task-053: Write copy \u0026 announce   → Morgan (marketing)\n\nSam is starting now. You'll be notified when approvals are needed.\n```\n\n1. You give intent\n2. CEO agent decomposes into tasks\n3. Agents execute: strategist → planner → developer → reviewer → devops\n4. You approve at gates (merge, deploy, spend)\n5. Workflow execution is tracked durably in SQLite\n6. Files remain the authored source of truth. Every action is still git-auditable.\n\n---\n\n## Workflow Runtime Model\n\nAutopilot treats workflows as the primary execution primitive.\n\n- `team/workflows/*.yaml` defines the authored workflow structure\n- the orchestrator compiles workflows into explicit step contracts\n- SQLite stores runtime execution in `workflow_runs` and `step_runs`\n- Durable Streams stores append-only replay timelines for sessions and workflow events\n\nAgents execute the current step. The app owns validation, transition state, deduplication, and replayability.\n\n---\n\n## Your Team, Your Rules\n\nAutopilot ships with 8 default agents across 8 roles — meta, strategist, planner, developer, reviewer, devops, marketing, design. Customize them or create your own in `team/agents/*.yaml`.\n\n```yaml\n# team/agents/max.yaml\nid: max\nname: Max\nrole: developer\ndescription: Implementation, tests, debugging\nmodel: anthropic/claude-sonnet-4\ntools: [fs, terminal]\nfs_scope:\n  read: [\"**\"]\n  write: [\"**\"]\n```\n\n---\n\n## Architecture\n\n```\nHuman         CLI · Dashboard · Telegram · Webhooks\n  │\nOrchestrator  Watcher · Workflows · Spawner · Context · Memory · Cron · Durable Streams\n  │\nAgents        TanStack AI + OpenRouter · Per-Agent Model Picker · 7 Tools · Sandboxed FS · Memory\n  │\nStorage       SQLite + Drizzle · YAML/MD/JSON · FTS5 + sqlite-vec · Git\n```\n\n- **Config is files** — YAML, Markdown, JSON. `ls` your company config.\n- **Runtime is SQLite** — tasks, messages, sessions, workflow runs, step runs, search. Zero external deps.\n- **Git is the audit trail** — every agent action = commit.\n- **MCP server** — expose Autopilot to Claude Desktop/Code via tasks, agents, search, sessions.\n- **Durable Streams** — append-only session and workflow timelines with live tailing and replay.\n- **Per-agent model picker** — assign different models to different agents via OpenRouter.\n- **One Bun process** — orchestrator + API + dashboard. ~100MB RAM.\n- **Same-origin browser auth** — dashboard traffic stays on one origin; API proxying is handled by Vite in dev and Caddy in Docker/self-hosted setups.\n\n---\n\n## Self-Hosted\n\nAutopilot is designed to run on YOUR infrastructure. No SaaS lock-in.\n\n| Setup | Command | Cost |\n|-------|---------|------|\n| Local (macOS/Linux) | `bunx @questpie/autopilot start` | Free (+ API costs) |\n| Docker | `docker compose up` | Free (+ API costs) |\n| Hetzner VPS | [One-click deploy →](docs/guides/vps-deployment.md) | €4.35/mo + API |\n| Any VPS | `curl ... install.sh \\| bash` | Your VPS + API |\n\n[→ Full VPS deployment guide](docs/guides/vps-deployment.md)\n\n---\n\n## CLI Reference\n\n```bash\nautopilot init \u003cname\u003e        # Create a new company\nautopilot start              # Start orchestrator + dashboard\nautopilot ask \"\u003cintent\u003e\"     # Send intent to CEO\nautopilot status             # Company overview\nautopilot tasks              # List tasks\nautopilot agents             # List agents\nautopilot attach \u003cagent\u003e     # Watch agent work (live)\nautopilot inbox              # Pending approvals\nautopilot approve \u003cid\u003e       # Approve action\nautopilot reject \u003cid\u003e        # Reject action\nautopilot chat \u003cagent\u003e       # Direct chat with agent\nautopilot dashboard          # Open web dashboard\nautopilot secrets            # Manage API keys\nautopilot auth               # Manage authentication\nautopilot provider set \u003cp\u003e   # Configure AI provider (openrouter)\n```\n\n---\n\n## Company Structure\n\n```\nmy-company/\n├── company.yaml              # Company configuration\n├── team/\n│   ├── agents/               # AI agent definitions (one file per agent)\n│   ├── humans/               # Human team members (one file per human)\n│   ├── roles.yaml            # RBAC role definitions\n│   ├── schedules/            # Cron-triggered jobs (one file per schedule)\n│   ├── webhooks/             # External webhook integrations (one file per webhook)\n│   ├── workflows/            # development (12), marketing (7), incident (8)\n│   └── policies/             # Human approval requirements\n├── knowledge/                # Searchable knowledge base (markdown)\n├── skills/                   # Agent skills (agentskills.io, 20 built-in)\n├── dashboard/                # Living dashboard (pins, widgets, pages)\n├── tasks/                    # Task status directories (runtime)\n├── comms/                    # Communication channels (runtime)\n├── logs/                     # Activity \u0026 session logs (runtime)\n├── context/memory/           # Per-agent persistent memory (runtime)\n├── secrets/                  # Encrypted secrets (runtime)\n├── projects/                 # Project workspaces (runtime)\n├── artifacts/                # Generated apps \u0026 content (runtime)\n└── .data/autopilot.db        # SQLite (tasks, messages, workflow_runs, step_runs, FTS5, embeddings)\n```\n\n\u003e **Note:** Tasks, messages, activity, workflow runs, and step runs are stored in SQLite (`.data/autopilot.db`), not as YAML files. Runtime directories are created by `autopilot init`, not from the template.\n\n\u003e **Config format:** Legacy monolithic files (`team/agents.yaml`, `team/humans.yaml`, `team/webhooks.yaml`, `team/schedules.yaml`) are no longer supported. Use folder-based config only.\n\n---\n\n## Deploy to Hetzner\n\nBest price/performance for self-hosting. ARM64 servers from €4.35/mo.\n\n```bash\n# On your Hetzner VPS (Ubuntu 24.04):\ncurl -fsSL https://get.docker.com | sh\nmkdir -p /opt/autopilot \u0026\u0026 cd /opt/autopilot\ncurl -fsSL https://raw.githubusercontent.com/questpie/autopilot/main/install.sh | bash\n```\n\n[Get €20 free credits →](https://hetzner.cloud/?ref=Akyzglz8k22M)\n\n---\n\n## Documentation\n\n- [Getting Started](docs/getting-started.md)\n- [Architecture](docs/architecture.md)\n- [Agents \u0026 Roles](docs/agents.md)\n- [Internal Workflow Memo](docs/internal/workflow-operating-memo.md)\n- [Config Folder Migration](docs/guides/config-folder-migration.md)\n- [CLI Reference](docs/cli.md)\n- [VPS Deployment](docs/guides/vps-deployment.md)\n- [Docker Guide](docs/guides/docker.md)\n- [Security \u0026 Auth](docs/security.md)\n\n---\n\n## Contributing\n\n```bash\ngit clone https://github.com/questpie/autopilot.git\ncd autopilot \u0026\u0026 bun install\nbunx turbo build\nbunx turbo test\n```\n\n---\n\n## License\n\n[MIT](LICENSE) — QUESTPIE s.r.o. 2026\n\n\u003cdiv align=\"center\"\u003e\n\nBuilt by [QUESTPIE](https://questpie.com)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquestpie%2Fautopilot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquestpie%2Fautopilot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquestpie%2Fautopilot/lists"}