# routa | Fengda Huang | Knowledge Base | Instagit

Workspace-first multi-agent coordination platform for AI development, with shared Specs, Kanban orchestration, and MCP/ACP/   A2A support across web and desktop.

GitHub Stars: 1.5k

Repository: https://github.com/phodal/routa

---

## Articles

### [How to Run E2E Tests with Playwright for UI Coverage in Routa](/phodal/routa/how-to-run-e2e-tests-with-playwright-for-ui-coverage-in-routa)

Learn how to run E2E tests with Playwright for comprehensive UI coverage in Routa. Ensure consistent testing across web and desktop frontends for robust application quality.

- Tags: how-to-guide
- Published: 2026-05-26

### [Routa API Contract and Endpoint Inventory: Complete OpenAPI 3.1 Reference](/phodal/routa/what-is-the-api-contract-and-endpoint-inventory-for-routa)

Explore the Routa API contract and endpoint inventory. This OpenAPI 3.1 reference details REST endpoints for agents, tasks, workspaces, skills, and Git operations used by the Next.js front-end and Rust back-end.

- Tags: api-reference
- Published: 2026-05-26

### [How to Implement Skill-Based Agent Workflows and Orchestrators in Routa](/phodal/routa/how-to-implement-skill-based-agent-workflows-and-orchestrators-in-routa)

Learn to implement skill-based agent workflows and orchestrators in Routa. Explore its three-layer architecture for dynamic prompt loading and runtime resolution.

- Tags: how-to-guide
- Published: 2026-05-26

### [How to Set Up Docker Deployment with PostgreSQL for Routa: A Complete Guide](/phodal/routa/how-to-set-up-docker-deployment-with-postgresql-for-routa)

Easily deploy Routa with PostgreSQL using Docker. Switch from SQLite to PostgreSQL with simple environment variables. Get the complete setup guide.

- Tags: how-to-guide
- Published: 2026-05-26

### [Routa Session Lifecycle and Reconnection Flow: Managing ACP Sessions Across Network Interruptions](/phodal/routa/what-is-the-session-lifecycle-and-reconnection-flow-in-routa)

Explore the Routa session lifecycle and reconnection flow managing ACP sessions across network interruptions. Built with a seven-phase lifecycle and auto-reconnecting Server-Sent Events.

- Tags: internals
- Published: 2026-05-26

### [How to Use routa-cli for Terminal-First Workflows: Complete Command Reference](/phodal/routa/how-to-use-the-cli-routa-cli-for-terminal-first-workflows)

Master routa-cli for terminal-first workflows. Manage agents tasks and workflows via shell commands with this complete command reference. Boost productivity today.

- Tags: how-to-guide
- Published: 2026-05-26

### [How to Build and Run the Routa Desktop App with Tauri](/phodal/routa/how-to-build-and-run-the-desktop-app-with-tauri-using-routa)

Learn to build and run the Routa desktop app with Tauri. Follow simple steps to bundle your Next.js frontend into a native application for development or production.

- Tags: how-to-guide
- Published: 2026-05-26

### [A2A, AG-UI, and A2UI Integration Protocols in Routa: A Complete Technical Guide](/phodal/routa/what-are-the-a2a-ag-ui-and-a2ui-integration-protocols-in-routa)

Explore Routa's A2A, AG-UI, and A2UI integration protocols. Learn how JSON-RPC, SSE streaming, and declarative JSON enable seamless agent and UI interactions in this technical guide.

- Tags: deep-dive
- Published: 2026-05-26

### [How to Configure Desktop-Aware Fetch for Tauri Runtime (127.0.0.1:3210) in Routa](/phodal/routa/how-to-configure-desktop-aware-fetch-for-tauri-runtime-1270013210-in-routa)

Configure desktop-aware fetch for Tauri runtime in Routa. Automatically rewrite API calls to 127.0.0.1:3210 in Tauri webview and use standard HTTP endpoints for web.

- Tags: how-to-guide
- Published: 2026-05-26

### [How to Set Up SQLite Database with Drizzle ORM for Persistence in Routa](/phodal/routa/how-to-set-up-sqlite-database-with-drizzle-orm-for-persistence-in-routa)

Learn to set up SQLite database with Drizzle ORM in Routa. This guide covers Drizzle-Kit migrations, schema definitions, and runtime initialization for persistent data.

- Tags: how-to-guide
- Published: 2026-05-26

### [How to Debug Tauri Desktop App Routes and Backend Fallback Mapping in Routa](/phodal/routa/how-to-debug-tauri-desktop-app-routes-and-backend-fallback-mapping-in-routa)

Debug Tauri desktop app routes and backend fallback mapping in Routa. Verify server logs, static_dir path, and workspace ID rewriting for seamless SPA fallback.

- Tags: how-to-guide
- Published: 2026-05-26

### [What Is the ACP (Agent Communication Protocol) Runtime in Routa?](/phodal/routa/what-is-the-acp-agent-communication-protocol-runtime-in-routa)

Discover the ACP runtime in Routa, the core subsystem hosting Agent Communication Protocol sessions. Learn how it launches, supervises, and communicates with external agent processes using JSON-RPC.

- Tags: deep-dive
- Published: 2026-05-26

### [How to Customize Specialist Prompts for Each Kanban Lane in Routa](/phodal/routa/how-to-customize-specialist-prompts-for-each-kanban-lane-in-routa)

Customize specialist prompts for each Kanban lane in Routa. Bind custom YAML specialist definitions to Kanban columns for tailored AI automation. Learn how to enhance your workflow now.

- Tags: how-to-guide
- Published: 2026-05-26

### [How to Set Up Schedules, Webhooks, and Background Task Automation in Routa](/phodal/routa/how-to-set-up-schedules-webhooks-and-background-task-automation-in-routa)

Learn to automate background tasks using Routa's cron-style scheduling and webhook handlers in TypeScript and Rust. Effortlessly integrate external events into your workflows.

- Tags: how-to-guide
- Published: 2026-05-26

### [How to Manage Local Repositories, Worktrees, and Git Operations with Routa](/phodal/routa/how-to-manage-local-repositories-worktrees-and-git-operations-with-routa)

Master local repositories, worktrees, and Git operations with Routa. This tool isolates agent tasks using disposable worktree environments and prevents race conditions with repository locks.

- Tags: how-to-guide
- Published: 2026-05-26

### [How to Implement Review Gates with Harness Monitor and Evidence Requirements in Routa](/phodal/routa/how-to-implement-review-gates-with-harness-monitor-and-evidence-requirements-in-routa)

Implement review gates in Routa using Harness Monitor and evidence requirements. Enforce quality checks with Entrix Fitness and Gate Specialist for robust code delivery.

- Tags: how-to-guide
- Published: 2026-05-26

### [Entrix Fitness Gate System: Continuous Quality Validation in Routa](/phodal/routa/what-is-the-entrix-fitness-gate-system-and-how-is-it-used-for-quality-validation-in-routa)

Discover the Entrix fitness gate system for continuous quality validation in Routa. Learn how it parses Markdown, runs shell commands, and blocks regressions to ensure code integrity.

- Tags: deep-dive
- Published: 2026-05-26

### [How to Configure Provider Runtimes Like OpenAI, Claude, and OpenCode with Adapters in Routa](/phodal/routa/how-to-configure-provider-runtimes-like-openai-claude-and-opencode-with-adapters-in-routa)

Configure AI provider runtimes like OpenAI, Claude, and OpenCode using adapters in Routa. Normalize LLM interfaces and handle protocol differences automatically for unified access.

- Tags: how-to-guide
- Published: 2026-05-26

### [How to Integrate GitHub Repositories as Virtual Workspaces in Routa](/phodal/routa/how-to-integrate-github-repositories-as-virtual-workspaces-in-routa)

Learn how to integrate GitHub repositories as virtual workspaces in Routa. Easily clone and link your GitHub code for seamless access with agents and Kanban boards.

- Tags: how-to-guide
- Published: 2026-05-26

### [How to Set Up Workspace-Scoped Agent Sessions with Streaming and Trace Inspection in Routa](/phodal/routa/how-to-set-up-workspace-scoped-agent-sessions-with-streaming-and-trace-inspection-in-routa)

Learn to set up workspace-scoped agent sessions in Routa. Stream prompts, inspect traces via JSONL or Postgres, and visualize them in the TracePanel component for efficient debugging.

- Tags: how-to-guide
- Published: 2026-05-26

### [How Routa’s Kanban Lane Specialist System Works: Automating Workflows with AI Agents](/phodal/routa/how-does-routa-s-kanban-lane-specialist-system-work)

Discover how Routa’s Kanban lane specialist system works. Learn how AI agents automate complex workflows and enforce quality gates for efficient task management.

- Tags: deep-dive
- Published: 2026-05-26

### [Routa's Dual-Backend Architecture: Next.js Web vs Tauri Desktop Explained](/phodal/routa/what-is-routas-dual-backend-architecture-nextjs-web-vs-tauri-desktop)

Explore Routa's dual-backend architecture: Next.js web and Tauri desktop. Learn how unified domain logic ensures seamless API parity across platforms via a shared OpenAPI contract.

- Tags: architecture
- Published: 2026-05-26

### [How to Configure MCP Tools and Custom MCP Servers in Routa](/phodal/routa/how-to-configure-mcp-tools-and-custom-mcp-servers-in-routa)

Learn how to configure MCP tools and custom MCP servers in Routa. Control tool exposure to agents with built-in coordination and REST API registration for stdio, HTTP, and SSE servers.

- Tags: how-to-guide
- Published: 2026-05-26