From 94cb16db0a66474e3b4ce70681b3a07d9245b1fa Mon Sep 17 00:00:00 2001 From: Serhii Vecherenko Date: Sun, 2 Aug 2026 16:58:48 -0700 Subject: [PATCH] docs(readme): document MCP, workspaces, SSH, checkpoints, worktrees - Highlight built-in MCP for agent and app orchestration - Add sections for checkpoints/rollback, project workspaces, and git worktrees - Document live usage & limits and remote machines over SSH - Expand in-app PRs with AI-driven automation coverage --- README.md | 54 +++++++++++++++++++++++++++++++++++++++++++++++------- 1 file changed, 47 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 613b24de..bc77efe0 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@

One window for all your AI coding agents.
- Run Claude, Codex, OpenCode, Gemini, Grok, Kimi Code, Qwen Code, Pi, Qoder, Factory Droid, Antigravity, Cursor, Command Code, and Copilot side-by-side. Terminal and chat, any layout. + Run Claude, Codex, OpenCode, Gemini, Grok, Kimi Code, Qwen Code, Pi, Qoder, Factory Droid, Antigravity, Cursor, Command Code, and Copilot side-by-side. Terminal and chat, any layout — with built-in MCP so agents can orchestrate each other and the app itself.

@@ -33,15 +33,51 @@ If you use more than one AI coding agent, you know the pain: separate terminals, ### Infinite Threads & Layouts -Open as many agent threads as you need and arrange them in horizontal and vertical splits. Resize, stack, and rearrange freely. The layout stays fast no matter how many threads you have running. +Mix TUI and GUI agents in any configuration. Open as many threads as you need, arrange them in horizontal and vertical splits, and resize freely. The layout stays fast no matter how many sessions you have running. ### Unified Protocol GUI -Agents that support structured APIs (like ACP or provider SDKs) get a proper chat interface with markdown, syntax highlighting, and tool call displays. +A consistent chat interface for ACP and SDK agents — markdown, syntax highlighting, and tool call displays. Where a provider offers more than one runtime (for example Cursor ships CLI, ACP, and SDK), you pick which one a thread runs on. -### Cross-Agent Orchestration +### Crossagents -Let agents delegate work to other installed agents across providers, while you follow their live progress and approve actions from the parent thread. +Let one agent delegate work to another across providers. Subagent output streams into the parent thread, background runs finish while the parent keeps working, and you can pin routing rules per task type. + +### Built-in MCP & App Controls + +Poracode ships its own MCP servers. Point any agent at them to create and steer threads, organize projects, list and merge Git worktrees, commit and sync, open and merge pull requests, schedule runs, manage skills, and change settings — or add your own MCP servers over stdio, HTTP, or SSE. + +### Agent Experiments + +Run one prompt across several agents in parallel worktrees, then let an AI judge compare their code and answers, crown a winner, and merge it or open a PR. + +### Scheduled Runs + +Put recurring work on a schedule — nightly reviews, dependency sweeps, changelog drafts — and let Poracode start the thread for you. + +### Skills & Marketplace + +Browse and install skills from public marketplaces, or import your own. One shared folder that every provider picks up automatically. + +### On-Device Voice Input + +Dictate a prompt with a keystroke. Whisper runs locally, with optional GPU acceleration, so your audio never leaves the machine. + +### Checkpoints & Rollback + +Rewind a conversation to any earlier message and restore the files with it, with a warning first when another thread shares the same tree. + +### Project Workspaces + +Group projects into workspaces and switch the whole sidebar between them, so dozens of repos stay one click apart. + +### Git Worktrees + +Group threads by worktree and drive parallel branches side by side, without leaving the app. + +### Live Usage & Limits + +See session and weekly quota for every provider — Claude Max, ChatGPT Pro, and more — at a glance. ### Terminal Fidelity @@ -63,9 +99,13 @@ Open web pages, attach browser context to agents, and keep research in the same Pair the Poracode web app with your desktop to follow live threads, read terminal output, send messages, and receive notifications from your phone or browser. -### In-App GitHub PRs +### Remote Machines over SSH + +Connect a server from your SSH config and Poracode installs its runtime there, then runs agents on that machine — clone repos, open threads, and drive projects that never leave the box. + +### In-App PRs -View diffs, stage files, generate commit messages with AI, and review GitHub PRs directly inside Poracode. +Review pull requests, browse diffs, stage changes, and generate AI commits — then let automation watch the PR, fix what fails, merge with your chosen method, and mark the thread done. ### Code Editor