◆ CLI agent · 8 providers · MCP · ACP · RAG · Figma
It seeks. It ships premium-grade slop.
PoopSeek is an interactive TUI agent in TypeScript + Bun. One prompt at the › and it reads your files, runs your shell, walks MCP servers, delegates to other agents and generates real Figma UI — planning every step on its own, up to 256 of them.
A seriously engineered agent wearing a gremlin costume. The pun is on DeepSeek.
$ curl -fsSL https://raw.githubusercontent.com/Aver005/poopseek/main/install.sh | bash01 / backends
Eight brains behind one prompt
Switch model mid-conversation with /switch. Start free on DeepSeek web, escalate to a frontier model only when the task earns it.
/switch/authAuth per provider with /auth. The default is DeepSeek web — a hand-written client with proof-of-work, no key required.
02 / agent loop
Plans, acts, observes — repeat
Every turn is an autonomous multi-step loop with streaming, AbortSignal and rate-limit retry. It keeps going until the job is done, not until a fixed step count runs out.
Plan
Reads the request, picks tools, drafts a todo list you can watch fill in real time.
Act
Fires up to 24 tool calls per step — read, write, shell, git, search, sub-agents.
Observe
Feeds results back into context, refreshes ~every 64k tokens, corrects course.
03 / toolbelt
31+ tools, one static registry
No plugin ceremony — one file per tool, wired into a single registry. The agent reaches for these the way you reach for muscle memory.
file.readfile.writefile.editfile.findfile.listfile.removebashpowershellgitgit.editgrepcodebase.indexcodebase.searchthesvg.searchagent.askagent.paralleltodo.writetodo.readmemory.savememory.readmemory.listuser.askuser.choiceuser.confirmtools.listskill.readrole.savemcp.describemcp.readweb.searchweb.fetchevery name below is a real tool id.
04 / codebase RAG
Stops crawling files through five greps
Hybrid semantic search — dense embeddings fused with BM25 via Reciprocal Rank Fusion. The agent sees the relevant chunks at once instead of spelunking.
- ✓Runs offline and free — a ~120 MB multilingual model, downloaded once, shared across every project.
- ✓Local SQLite store with FTS5. No ANN index: a full cosine scan over 384-dim vectors lands in milliseconds under ~50k chunks.
- ✓Flip it any time with /rag on · /rag off. Index lives in ~/.poopseek/rag/.
05 / wired in
It speaks the protocols your tools already speak
PoopSeek is not an island. It plugs into your editors, your MCP servers, and your design canvas.
MCP
clientstdio + Streamable HTTP. Auto-discovers servers from Claude Desktop, VS Code, Cursor and Trae. A 5-minute status cache skips the broken ones.
ACP
both rolesRuns as an ACP server for Zed / JetBrains / Neovim — and as a client that drives other agents like Claude Code and Gemini CLI.
$ poopseek --acpFigma
designer → builder → handymanA local HTTP/SSE server turns a text brief into real Figma UI through a three-stage pipeline. Listens on port 7331.
$ poopseek --figma06 / command palette
Everything is one slash away
Natural language for the work, slash-commands for the machinery. Two of them are hidden.
- /helplist every command
- /clearwipe history — fresh dialogue
- /compactshrink history via an LLM summary
- /modelchange model inside the provider
- /switchquick provider switch
- /authmanage provider tokens
- /mcpMCP servers: list / tools / connect / reload
- /acpACP agents: add / connect / send / use
- /ragsemantic code search: status / init / on / off
- /skillsmanage agent skills
- /roleswitch the active role
- /thinktoggle thinking mode
- /webtoggle web search
- /refactorrun the refactor pipeline
- /reviewrun the review pipeline
- /btwbackground sidechat — no interruption
- /maestrohiddenactivate every skill at once
- /noobhiddenreset skills back to zero
hover a row