# Paca Documentation

> Reference for Paca, a self-hosted AI-native project management platform: Docker deployment, REST and Socket.IO contracts, MCP tools, WASM plugins, and OpenHands agent orchestration.

This is a Grok-Wiki source-grounded repository documentation set. Use the complete Markdown link when an agent needs the full repo context.

## Context Links

- [Complete Markdown docs](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/llms-full.txt)
- [Complete Markdown alias](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25.md)
- [Human interactive docs](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25)
- [GitHub repository](https://github.com/Paca-AI/paca)

## Repository

- Repository: Paca-AI/paca

- Generated: 2026-06-13T22:14:29.542Z
- Updated: 2026-06-13T22:14:50.201Z
- Runtime: Grok CLI
- Format: Documentation
- Pages: 23

## Pages

- [Overview](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/01-overview.md): What Paca exposes, runtime surfaces (web, API, realtime, MCP, ai-agent), and the shortest path from install to first project and API key.
- [Installation](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/02-installation.md): Prerequisites, install script, manual Docker Compose setup, required secrets, and optional stack scaling (external Postgres, S3, no ai-agent).
- [Quickstart](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/03-quickstart.md): First successful run: start the stack, log in as admin, create a project, generate an API key, and verify health endpoints.
- [Platform architecture](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/04-platform-architecture.md): Monorepo runtime areas, service boundaries, Valkey event decoupling, and nginx gateway routing between web, API, realtime, and storage.
- [Interaction views](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/05-interaction-views.md): Unified view and task-list model for sprint, backlog, and timeline contexts; query parameters, manual ordering, and shared REST paths.
- [AI agents](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/06-ai-agents.md): Agent members, trigger types, OpenHands conversation lifecycle, Docker isolation, Valkey streams, and how agents participate as project teammates.
- [Plugin system](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/07-plugin-system.md): WASM backend sandbox, frontend extension points, MCP plugin tools, capability permissions, and marketplace-driven install lifecycle.
- [Deploy production](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/08-deploy-production.md): Production Docker Compose topology, nginx gateway, storage backends (MinIO vs S3), secret generation, and scaling optional services.
- [Local development](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/09-local-development.md): Dev Compose stack, hot-reload per service, host-side run commands, infra-only mode, and port map through the nginx gateway.
- [Connect MCP server](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/10-connect-mcp-server.md): Configure @paca-ai/paca-mcp with npx for Claude Desktop, VS Code, or any MCP client; env vars, agent mode, and plugin tool loading.
- [Claude Code skills](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/11-claude-code-skills.md): Install /paca slash commands, wire the MCP server, available skill routes, and task-reference resolution patterns from skills/paca.
- [Configure AI agents](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/12-configure-ai-agents.md): Create agent types and project agents, set LLM and MCP config, wire repository access via plugin adapters, and control conversation lifecycle.
- [Build a plugin](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/13-build-a-plugin.md): End-to-end plugin authoring: plugin.json manifest, WASM backend, frontend extension points, migrations, build output, and local install.
- [Install marketplace plugins](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/14-install-marketplace-plugins.md): Install plugins from the Paca-AI/paca-plugins catalog via the admin UI or API; artifact layout, migrations, and filesystem install scripts.
- [REST API reference](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/15-rest-api-reference.md): Versioned /api/v1 paths, auth cookies and bearer tokens, response envelopes, pagination, and implemented endpoint catalog by resource.
- [Task activity API](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/16-task-activity-api.md): Unified activity and comment feed, activity_type values, JSONB content shapes, diff/revert semantics, and list/mutation endpoints.
- [Realtime events](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/17-realtime-events.md): Socket.IO connection auth, Valkey pub/sub fan-out, project and conversation rooms, and domain event payloads including agent monitoring.
- [MCP tools reference](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/18-mcp-tools-reference.md): All @paca-ai/paca-mcp tool names by category, input schemas, agent-mode constraints, and dynamically loaded plugin tools.
- [Configuration reference](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/19-configuration-reference.md): Environment variables across API, web gateway, realtime, and ai-agent: JWT, storage, plugins, encryption, cache TTLs, and internal keys.
- [Plugin SDK reference](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/20-plugin-sdk-reference.md): Typed APIs for @paca-ai/plugin-sdk-react, plugin-sdk-go host bridge, and @paca-ai/plugin-sdk-mcp; extension points and scoped HTTP clients.
- [Troubleshooting](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/21-troubleshooting.md): Common install and runtime failures: health checks, auth cookies, Valkey connectivity, storage misconfiguration, and MCP connection errors.
- [Upgrade and migration](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/22-upgrade-and-migration.md): Pull new images, automatic DB migrations on API startup, compose project rename volume migration, and version upgrade verification signals.
- [Contributing](https://www.grok-wiki.com/public/docs/paca-ai-paca-f238b2ab3d25/pages/23-contributing.md): Repository layout, dev prerequisites, PR checklist, test surfaces (Go integration, Playwright e2e), and documentation update expectations.

## Source Files

- `.github/PULL_REQUEST_TEMPLATE.md`
- `apps/e2e/README.md`
- `apps/mcp/.env.example`
- `apps/mcp/ALL_TOOLS.md`
- `apps/mcp/README.md`
- `apps/mcp/src/api/client.ts`
- `apps/mcp/src/index.ts`
- `apps/mcp/src/permissions.ts`
- `apps/mcp/src/plugin-loader.ts`
- `apps/mcp/src/server.ts`
- `apps/mcp/src/tools/index.ts`
- `apps/mcp/src/tools/project-tools.ts`
- `apps/mcp/src/tools/task-activity-tools.ts`
- `apps/mcp/src/tools/task-tools.ts`
- `apps/web/package.json`
- `apps/web/src/components/projects/docs/doc-activity-pane.tsx`
- `apps/web/src/lib/diff-utils.ts`
- `apps/web/src/lib/interaction-api.ts`
- `apps/web/src/lib/socket-client.ts`
- `CODE_OF_CONDUCT.md`
- `CONTRIBUTING.md`
- `deploy/.env.dev.example`
- `deploy/.env.production.example`
- `deploy/docker-compose.dev.yml`
- `deploy/docker-compose.prod.yml`
- `deploy/nginx/gateway.conf`
- `deploy/README.md`
- `docs/ai-agent/ai-agent-service.md`
- `docs/ai-agent/default-skills.md`
- `docs/ai-agent/overview.md`
- `docs/ai-agent/realtime-events.md`
- `docs/ai-agent/repository-plugin-adapter.md`
- `docs/api/http-design.md`
- `docs/api/README.md`
- `docs/api/task-activity.md`
- `docs/architecture/database-schema.md`
- `docs/architecture/interaction-views.md`
- `docs/architecture/manual-sort-algorithm.md`
- `docs/architecture/overview.md`
- `docs/architecture/repository-structure.md`
- `docs/architecture/service-boundaries.md`
- `docs/guides/claude-code-skill.md`
- `docs/guides/getting-started.md`
- `docs/guides/local-development.md`
- `docs/guides/mcp-server-setup.md`
- `docs/plugins/backend-plugin-system.md`
- `docs/plugins/developer-guide.md`
- `docs/plugins/frontend-plugin-system.md`
- `docs/plugins/marketplace.md`
- `docs/plugins/mcp-plugin-system.md`
- `docs/plugins/overview.md`
- `docs/plugins/sdk-reference.md`
- `docs/product/overview.md`
- `docs/README.md`
- `README.md`
- `ROADMAP.md`
- `scripts/install-claude-skill.sh`
- `scripts/install-local-plugin.sh`
- `scripts/install-plugin.sh`
- `scripts/install.sh`
- `SECURITY.md`
- `services/ai-agent/.env.example`
- `services/ai-agent/src/agent/builder.py`
- `services/ai-agent/src/config.py`
- `services/ai-agent/src/main.py`
- `services/ai-agent/src/worker.py`
- `services/api/.env.example`
- `services/api/.golangci.yml`
- `services/api/docker-entrypoint.sh`
- `services/api/internal/transport/http/dto/plugin_dto.go`
- `services/api/internal/transport/http/handler/agent_handler.go`
- `services/api/internal/transport/http/handler/apikey_handler.go`
- `services/api/internal/transport/http/handler/auth_handler.go`
- `services/api/internal/transport/http/handler/conversation_handler.go`
- `services/api/internal/transport/http/handler/health_handler.go`
- `services/api/internal/transport/http/handler/plugin_handler.go`
- `services/api/internal/transport/http/handler/task_handler.go`
- `services/api/internal/transport/http/handler/view_handler.go`
- `services/api/internal/transport/http/middleware/authz.go`
- `services/api/internal/transport/http/presenter/response.go`
- `services/api/internal/transport/http/router/router.go`
- `services/api/Makefile`
- `services/realtime/.env.example`
- `services/realtime/package.json`
- `services/realtime/README.md`
- `services/realtime/src/server.ts`
- `services/realtime/src/session.ts`
- `services/realtime/src/subscriber.ts`
- `skills/paca-epic/SKILL.md`
- `skills/paca-setup/SKILL.md`
- `skills/paca/SKILL.md`