f/poke-tui
🌴 Chat with your Poke AI assistant from the terminal
Platform-specific configuration:
{
"mcpServers": {
"poke-tui": {
"command": "npx",
"args": [
"-y",
"poke-tui"
]
}
}
}Add the config above to .claude/settings.json under the mcpServers key.
A terminal UI for Poke — chat with your AI assistant without leaving the terminal.
Built with Ink (React for CLIs) and the Poke SDK.
npx poke-tuiOn first run, you'll be guided through a one-time setup to paste your API key.
poke-tui connects to your Poke agent through the Poke API. You type messages in the terminal, and Poke responds inline — no need to switch to iMessage, Telegram, or SMS.
Behind the scenes, poke-tui runs a local MCP server and tunnels it to Poke's cloud using PokeTunnel. This gives the agent a reply_to_terminal tool it can call to send responses directly back to your terminal.
flowchart TD
A["You type a message"] --> B["Poke API (sendMessage)"]
B --> C["Poke Agent processes it"]
C --> D["Agent calls reply_to_terminal"]
D --> E["MCP Tunnel (WebSocket)"]
E --> F["Response in your terminal"]npx poke-tui and paste it when promptedThe key is saved to ~/.config/poke-tui/config.json for future sessions.
export POKE_API_KEY=your_key_here
npx poke-tuipoke-tui checks credentials in this order: POKE_API_KEY env var → ~/.config/poke-tui/config.json.
| Command | Description | |---------|-------------| | /help | Show available commands | | /status | Show connection status | | /webhook create <when> \| <do what> | Create a webhook trigger | | /webhook fire <#> {"data":"here"} | Fire a webhook with JSON data | | /webhooks | List active webhooks | | /clear | Clear the chat |
Create automated triggers that fire your Poke agent with data:
/webhook create When a deploy fails | SLoading reviews...