
Poke Gate
https://github.com/f/poke-gate- Category
- AI Agents
- Rank
- No. 1453Tools index
Previous survey · No. 1458 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- f
- GitHub
- 80 stars
- Latest release
- v0.3.7
- Date
About
Expose your machine to your Poke AI assistant via an MCP tunnel. Run remote shell and OS commands from Poke.
What it does
Poke Gate turns Poke chats into actions on a Mac. A menu bar app or terminal client signs in through Poke, maintains a cloud connection, and runs local tools for files, commands, system details, network tests, screenshots, and scheduled scripts.
Why it's ranked here
This is a focused, unusually complete bridge between conversational requests and local Mac automation. It combines guided setup, reconnect handling, logs, permission modes, approval tokens, and scheduled jobs. Its value is substantial, but tightly coupled to Poke and macOS-specific protections.
What's good
Three access modes offer meaningful control. Limited mode permits reading and selected commands, while Sandbox broadens command support under macOS restrictions. Risky actions use short-lived, argument-bound approval tokens. The connection retries automatically, and scheduled scripts support isolated environment files for credentials.
Tradeoffs
Full mode can execute commands with the user’s permissions and read or write accessible files. The native app requires macOS 15 or later, is not notarized, and may require manually clearing quarantine. Screenshot capture needs extra permission. Scheduled scripts execute as ordinary Node.js programs, so downloaded agents require trust.
How to use it well
It suits Poke users who want occasional remote diagnostics, file work, screenshots, or recurring personal automations on a trusted Mac. Start with Limited mode, move to Sandbox when commands need controlled writes, and reserve Full mode for deliberate tasks. It does not provide a general cross-platform remote administration layer or a Poke-independent assistant.
Technical notes+
package.json defines a Node.js 18+ ES module CLI with the poke package as its sole runtime dependency. src/app.js starts the local server, tunnel, retry loop, webhook notification, and scheduler. src/mcp-server.js implements MCP tools, command allowlists, access policies, loop suppression, and approval handling. src/permission-service.js binds five-minute HMAC approvals to sessions, tools, and hashed arguments. src/tunnel.js uses PokeTunnel, removes remembered stale connections, and retains a bounded connection history. src/agents.js discovers interval-named JavaScript jobs, injects per-agent environment values, runs jobs immediately and on timers, and limits each process to five minutes. src/download-macos.js installs the matching release DMG, removes the existing app, clears quarantine, and launches the replacement.
Observed
- License
- MIT
- Primary implementation
- JavaScript ES modules, plus a native SwiftUI macOS menu bar client
- Runtime
- Node.js 18 or later for the CLI
- Install surfaces
- Homebrew, npm via npx, GitHub release DMG, or source build with Xcode
- Interfaces
- CLI, native macOS menu bar app, and local MCP server tunneled to Poke
- Platform support
- Native app requires macOS 15 or later; screenshot and sandbox features are macOS-specific
- Authentication
- Poke OAuth through the browser, with an API key environment override
- Runtime dependency
- The npm package declares the Poke SDK as its sole production dependency
Read from README.md, package.json, src/app.js, src/agents.js, src/tunnel.js, src/webhook.js, src/poke-auth.js, src/mcp-server.js, src/agent-create.js, src/disconnect-all.js, src/download-macos.js, src/take-screenshot.js, src/permission-service.js, src/browser-session-token.js, docs/cli.md.
What it can do
Establish MCP tunnel connection
Local machine and Poke AI assistant → Secure tunnel connection
Execute remote shell commands
Shell command from Poke AI → Command execution results
Run operating system commands
OS command from Poke AI → System operation results
Expose machine resources to AI assistant
Local machine capabilities → Remote access interface
Process remote AI requests
Commands from Poke AI assistant → Executed command responses
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.