Poke TUI
https://github.com/f/poke-tui- Category
- AI Agents
- Rank
- No. 2043Tools index
Previous survey · No. 2038 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- f
- GitHub
- 16 stars
- Latest release
- v0.0.1
- Date
About
Chat with your Poke AI assistant from the terminal.
What it does
Poke TUI sends typed requests to a Poke agent, then routes replies back through a local MCP server exposed to Poke over a WebSocket tunnel. Its interactive screen shows messages, connection state, progress indicators, errors, and commands for creating or firing webhook triggers.
Why it's ranked here
This is a focused, understandable bridge between Poke and terminal workflows. The local MCP return channel is more substantial than a thin command wrapper, while onboarding, status feedback, and webhook controls make it practical. Its value remains narrow because it requires Poke credentials and depends on Poke’s cloud service.
What's good
Credential discovery supports an environment variable, saved configuration, and existing Poke login credentials. Connection loss is surfaced with a reconnecting message. Webhook commands validate their separator, index, and JSON input. The interface limits displayed history, shows activity while awaiting a response, and stops the tunnel when users quit.
Tradeoffs
Node.js 18 or newer and a Poke account are mandatory. API keys may be stored unencrypted in the user configuration directory. Chat history exists only in process memory. The webhook list starts empty each run, so the interface only tracks webhooks created during that session. If tunnel startup fails, replies fall back to the phone.
How to use it well
It suits developers who already use Poke and want conversational help beside shells, logs, and deployment work. Use webhook triggers to send structured operational events, such as failed-deploy details, into the agent. It does not replace a general MCP host, an offline assistant, or a persistent terminal chat archive.
Technical notes+
package.json defines an ESM Node.js package with a poke-tui executable at bin/poke-tui.js and dependencies on Ink, React, ink-text-input, and the Poke SDK. bin/poke-tui.js resolves credentials and performs onboarding before importing src/app.js. src/app.js connects EventEmitter-based TUI and MCP events to PokeClient. src/mcp-server.js implements raw JSON-RPC over HTTP on 127.0.0.1, exposes POST /mcp and GET /health, and advertises reply_to_terminal plus notify_terminal. src/poke-client.js prepends a terminal-routing instruction to messages, creates PokeTunnel, persists the connection ID, and manually requests tool synchronization. src/tui.js renders the Ink interface, retains a bounded in-memory message collection, and displays the latest 50 entries.
Observed
- License
- MIT
- Primary language
- JavaScript using ECMAScript modules
- Install surface
- npm executable, runnable with npx poke-tui
- Runtime
- Node.js 18 or newer
- Interface
- Interactive terminal UI with an embedded MCP HTTP server
- Cloud dependency
- Requires a Poke account and credentials
- MCP tools
- Exposes terminal reply and terminal notification tools
- Documented structure
- The documented project structure contains bin and src directories
Read from README.md, package.json, src/app.js, src/tui.js, src/mcp-server.js, src/poke-client.js, bin/poke-tui.js.
What it can do
Send text messages to AI assistant
Text prompts or questions → AI-generated responses
Conduct interactive conversations with AI
Conversational text input → Real-time AI chat responses
Access AI assistance from command line
Terminal commands and text queries → AI responses displayed in terminal
Get answers to questions via terminal interface
Natural language questions → AI-generated answers and explanations
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.