[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-1913":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":10,"languages":10,"totalLinesOfCode":10,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":12,"stars7d":16,"stars30d":17,"stars90d":15,"forks30d":15,"starsTrendScore":18,"compositeScore":19,"rankGlobal":10,"rankLanguage":10,"license":10,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":20,"hasPages":20,"topics":22,"createdAt":10,"pushedAt":10,"updatedAt":26,"readmeContent":27,"aiSummary":28,"trendingCount":15,"starSnapshotCount":15,"syncStatus":29,"lastSyncTime":30,"discoverSource":31},1913,"pool","poolsideai\u002Fpool","poolsideai","pool is Poolside’s coding agent that runs in your terminal or integrates with any ACP-compatible editor","https:\u002F\u002Fdocs.poolside.ai\u002Fcli\u002Fpool",null,220,8,7,1,0,17,61,24,2.86,false,"main",[23,24,25],"acp","agent","agent-client-protocol","2026-06-12 02:00:34","# pool\n\npool is [Poolside](https:\u002F\u002Fpoolside.ai)’s coding agent. It can run in several modes:\n\n- In your terminal as a standalone interactive application\n- As an [ACP](https:\u002F\u002Fagentclientprotocol.com\u002F) server with [a compatible editor](#run-as-an-acp-server-pool-acp)\n- As an ACP client connected to [an ACP server](#run-as-an-acp-client-pool---agent-server)\n- Non-interactively with `pool exec`.\n\n| Ghostty | Terminal.app |\n| --- | --- |\n| \u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F7c5befea-2e12-4aa1-809e-e9f25b057362\" \u002F> | \u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fd2088fa4-bf1b-438b-aec5-57dbb6716c0b\" \u002F> |\n\n## Contents\n\n- [Install](#install)\n- [Quick start](#quick-start)\n- [Modes](#modes)\n- [Spec support](#spec-support)\n- [Run as an ACP server (`pool acp`)](#run-as-an-acp-server-pool-acp)\n- [Run as an ACP client (`pool --agent-server`)](#run-as-an-acp-client-pool---agent-server)\n- [Run non-interactively (`pool exec`)](#run-non-interactively-pool-exec)\n- [MCP servers](#mcp-servers)\n- [Configuration](#configuration)\n- [Permissions](#permissions)\n- [Feedback and bugs](#feedback-and-bugs)\n\n## Install\n\nLinux and macOS:\n\n```bash\ncurl -fsSL https:\u002F\u002Fdownloads.poolside.ai\u002Fpool\u002Finstall.sh | sh\n```\n\nWindows (preview):\n```pwsh\nirm https:\u002F\u002Fdownloads.poolside.ai\u002Fpool\u002Finstall.ps1 | iex\n```\n\n## Quick start\n\nRun `pool` in any project:\n\n```bash\ncd your-project\npool\n```\n\nRun `pool -h` to see all available options.\n\n### Interactive features\n\n- Slash commands with `\u002F`\n- Fuzzy search over files and directories with `@`\n- Shell mode with `!`\n- Rewind to previous messages with double `esc`\n\nEnter `?` or `\u002Fhelp` during a session to see all available commands and shortcuts.\n\n## Modes\n\nBy default, pool asks for approval before each tool call. Switch to Accept edits or Allow all when you want it to take actions without prompting.\n\n| Mode          | ID             | What it does                                                       |\n| ------------- | -------------- | ------------------------------------------------------------------ |\n| Always ask    | `default`      | Prompts for approval on first use of each tool type                |\n| Accept edits  | `accept-edits` | Auto-approves workspace file reads and writes                      |\n| Allow all     | `allow-all`    | Approves tool calls automatically                                  |\n| Plan          | `plan`         | Plans changes without modifying your codebase                      |\n\nPress `Shift+Tab` to cycle through modes, or use `\u002Fmode \u003Cid>` to switch directly.\n\n## Spec support\n\npool implements and integrates with open agent specs:\n\n- **[AGENTS.md](https:\u002F\u002Fagents.md)**: pool automatically reads relevant `AGENTS.md` files from your project for project context and instructions.\n- **[Skills](https:\u002F\u002Fagentskills.io)**: load skills to extend pool with reusable workflows.\n- **[MCP](https:\u002F\u002Fmodelcontextprotocol.io)**: connect tools and data sources via [MCP servers](#mcp-servers).\n- **[ACP](https:\u002F\u002Fagentclientprotocol.com)**: runs as an [ACP server](#run-as-an-acp-server-pool-acp) inside editors and as an [ACP client](#run-as-an-acp-client-pool---agent-server) driving other agents.\n\n## Run as an ACP server (`pool acp`)\n\n`pool acp` is an [Agent Client Protocol](https:\u002F\u002Fagentclientprotocol.com) server. Use it from any ACP-compatible client.\n\n### Zed\n\n```bash\npool acp setup --editor zed\n```\n\nThis writes Poolside agent configuration to `~\u002F.config\u002Fzed\u002Fsettings.json`. Or add it manually:\n\n```json\n{\n  \"agent_servers\": {\n    \"Poolside\": {\n      \"command\": \"pool\",\n      \"args\": [\"acp\"],\n      \"type\": \"custom\"\n    }\n  }\n}\n```\n\n### JetBrains\n\n```bash\npool acp setup --editor jetbrains\n```\n\nThis writes configuration to `~\u002F.jetbrains\u002Facp.json`. Or add it manually:\n\n```json\n{\n  \"agent_servers\": {\n    \"Poolside\": {\n      \"command\": \"pool\",\n      \"args\": [\"acp\"]\n    }\n  }\n}\n```\n\n### Other editors\n\nPoint the editor's ACP configuration at `pool acp`:\n\n```json\n{\n  \"command\": \"pool\",\n  \"args\": [\"acp\"]\n}\n```\n\nTo pass flags to the ACP server, add them to the args array, for example `[\"acp\", \"--reasoning\", \"high\"]`.\n\n### ACP features\n\n- Session persistence: `session\u002Flist` and `session\u002Fload`\n- Session config options: mode and model. These can be persisted in `pool.json`\n  and are sent on startup using `session\u002Fset_config_option`\n- Slash commands advertised to the client\n\n## Run as an ACP client (`pool --agent-server`)\n\nBy default `pool` connects to Poolside's built-in agent through `pool acp`. You can also connect it to any other [ACP server](https:\u002F\u002Fagentclientprotocol.com\u002Fget-started\u002Fagents):\n\n```bash\n# Claude Agent\nnpm install -g @agentclientprotocol\u002Fclaude-agent-acp\npool --agent-server claude-agent-acp\n\n# Codex\nnpm install -g @zed-industries\u002Fcodex-acp\npool --agent-server codex-acp\n\n# Gemini\nnpm install -g @google\u002Fgemini-cli\npool --agent-server \"gemini --acp\"\n```\n\nTo set a non-Poolside server as the default, edit `~\u002F.config\u002Fpoolside\u002Fpool.json`:\n\n```json\n{\n  \"agent_servers\": {\n    \"default\": {\n      \"command\": \"claude-agent-acp\"\n    }\n  }\n}\n```\n\nFlags after `--` are forwarded to the ACP server `pool` is running. For example:\n\n```bash\npool -- --reasoning high\n```\n\n## Run non-interactively (`pool exec`)\n\nRun `pool exec` to send a single prompt and exit when the task is complete. Use this for scripts, CI pipelines, and one-off tasks.\n\n```bash\n# Inline prompt\npool exec -p \"scan cmd\u002Fcli code for vulnerabilities\" -o json --unsafe-auto-allow\n\n# Prompt from a file\npool exec -f prompt.txt -o json\n```\n\n## MCP servers\n\n`pool` can connect to [Model Context Protocol](https:\u002F\u002Fmodelcontextprotocol.io) servers to expose extra tools to the agent. Manage them with `pool mcp`:\n\n```bash\n# Command-based (stdio)\npool mcp add filesystem -- node filesystem-server.js\n\n# Remote HTTP server\npool mcp add --transport http notion https:\u002F\u002Fmcp.notion.com\u002Fmcp\n\n# Remote SSE server\npool mcp add --transport sse linear https:\u002F\u002Fmcp.linear.app\u002Fsse\n\n# Pass environment variables or HTTP headers\npool mcp add --env API_KEY=your-key myserver -- npx -y myserver-mcp\npool mcp add --transport http --header \"Authorization: Bearer $TOKEN\" svc https:\u002F\u002Fexample.com\u002Fmcp\n\n# Inspect and remove\npool mcp list\npool mcp get \u003Cname>\npool mcp remove \u003Cname>\n```\n\nServers are stored under `mcp_servers` in `~\u002F.config\u002Fpoolside\u002Fsettings.yaml`. You can also edit that file directly, or scope servers per-project by adding them to `.poolside\u002Fsettings.yaml`.\n\n## Configuration\n\nRun `pool config` to print the log, trajectory, and configuration directories, as well as the credentials file path. Run `pool config settings` to open `settings.yaml` in your editor.\n\nBy default, Poolside stores configuration files in `~\u002F.config\u002Fpoolside`. This includes `settings.yaml` (CLI settings), `credentials.json` (API token), and `pool.json` (agent server defaults).\n\nFor automation environments, set `POOLSIDE_API_KEY` instead of using stored credentials. `pool` checks it before reading from configuration files.\n\n## Permissions\n\nPermission rules can be set at three scopes:\n\n- `.poolside\u002Fsettings.local.yaml` – local, per-project (gitignored)\n- `.poolside\u002Fsettings.yaml` – shared per-project (checked in)\n- `~\u002F.config\u002Fpoolside\u002Fsettings.yaml` – personal defaults across projects\n\nWhen the same setting appears in multiple files, the most specific file wins.\n\n### Tool permissions\n\n```yaml\ntools:\n  shell:\n    allow:\n      - \"git log *\"\n      - \"rg *\"\n    deny:\n      - \"rm *\"\n      - \"git push *\"\n```\n\nHow tool rules work:\n\n- Tool rules support only `*` wildcards (`**` is not supported)\n- The rule string must match the tool call shown in the approval prompt\n- Subshells and composite shell commands always require manual approval\n- Shell commands that use control operators such as `|` are not auto-approved\n\n### Path permissions\n\n```yaml\npaths:\n  allow:\n    - path: ~\u002FDocuments\u002F**\n    - path: ~\u002Fworkspace\u002Fdocs\u002F**\n      write: true\n  deny:\n    - path: ~\u002F.ssh\u002F**\n    - path: ~\u002F.env\n```\n\nHow path rules work:\n\n- Paths are read-only by default; `write: true` allows edits, deletes, moves, renames\n- `deny` overrides `allow`\n- Path patterns support `*` and `**`\n- Use forward slashes for all paths, including Windows paths\n- In `.poolside\u002Fsettings.local.yaml`, paths must be relative to the project\n- In `~\u002F.config\u002Fpoolside\u002Fsettings.yaml`, paths must be absolute or start with `~`\n\n## Feedback and bugs\n\nRun `\u002Ffeedback` in an interactive session to send feedback or report a bug. To attach an earlier session, resume it first with `pool -r` and then run `\u002Ffeedback`.\n\n## License\n\nSee [LICENSE.md](https:\u002F\u002Fgithub.com\u002Fpoolsideai\u002Fpool\u002Fblob\u002Fmain\u002FLICENSE.md).\n","pool 是 Poolside 开发的一款编码助手，能够在终端独立运行或与任何 ACP 兼容的编辑器集成。其核心功能包括通过交互式命令、模糊搜索文件和目录、以及Shell模式等提高开发效率，并支持多种运行模式如ACP服务器、ACP客户端及非交互式执行。此外，它还遵循AGENTS.md、Skills、MCP等多项开放代理规范，以增强项目上下文理解能力和工作流扩展性。适用于需要在日常编程工作中提升代码编写速度与质量的各种场景，尤其是偏好使用命令行工具或希望将智能辅助功能直接整合进IDE内的开发者。",2,"2026-06-11 02:46:49","CREATED_QUERY"]