Getting Started
Install
Homebrew
The recommended way to install the macOS app:
bash
brew install f/tap/poke-gateManual download
Download the latest Poke.macOS.Gate.dmg from GitHub Releases, open it, and drag to Applications.
Since the app is not notarized, you may need to run:
bash
xattr -cr /Applications/Poke\ macOS\ Gate.appCLI only
If you don't need the macOS app:
bash
npx poke-gateSign in
Poke Gate uses Poke OAuth to authenticate. On first launch:
- Open Poke Gate from your menu bar
- The app starts and connects automatically
- If you're not signed in, a browser window opens for Poke OAuth
- After signing in, the connection is established
You can also sign in manually:
bash
npx poke loginVerify it works
Once connected, you'll see a green dot in the menu bar. The popover shows:
● Connected to your Poke, [your name]
Now open iMessage or Telegram and message your Poke:
"What's my hostname?"
Poke will use the system_info tool to answer from your machine.
What's next?
- How It Works — understand the architecture
- Tools — see all available tools
- Agents — set up scheduled automation