https://github.com/undivisible/poke-around
let poke use your computer, with macos, linux and windows support.
https://github.com/undivisible/poke-around
ai-agent automation computer-use mcp poke remote-control rs-peekaboo rust
Last synced: 8 days ago
JSON representation
let poke use your computer, with macos, linux and windows support.
- Host: GitHub
- URL: https://github.com/undivisible/poke-around
- Owner: undivisible
- License: mpl-2.0
- Created: 2026-04-01T03:21:55.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-06-06T06:44:13.000Z (10 days ago)
- Last Synced: 2026-06-06T07:02:19.203Z (10 days ago)
- Topics: ai-agent, automation, computer-use, mcp, poke, remote-control, rs-peekaboo, rust
- Language: Rust
- Homepage:
- Size: 7.77 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# Poke Around
Let your [Poke](https://poke.com) AI assistant access your machine.
A community project — not affiliated with Poke or The Interaction Company.
[](https://github.com/undivisible/poke-around/releases/latest)
[](https://github.com/undivisible/poke-around/blob/main/LICENSE)
---
Run Poke Around on your machine, then message Poke from iMessage, Telegram, or SMS to run commands, read files, take screenshots, and more — all on your machine.
## Install
**Install script (macOS / Linux)**
```bash
curl -fsSL https://raw.githubusercontent.com/undivisible/poke-around/main/scripts/install.sh | bash
```
**Homebrew (macOS / Linux)**
```bash
brew tap undivisible/tap
brew install poke-around
```
If install fails at **`brew link`** for **`simdjson`** (a dependency of Homebrew **node**), your prefix still has an older simdjson linked. Unlink it, then retry:
```bash
brew unlink simdjson
brew install poke-around
```
If Brew already poured a newer simdjson but could not link it, either run `brew link --overwrite simdjson` and retry, or `brew reinstall simdjson` after `brew unlink simdjson`.
**Build from source**
Requires stable [Rust](https://www.rust-lang.org/tools/install) and [Bun](https://bun.sh):
```bash
git clone https://github.com/undivisible/poke-around.git
cd poke-around
bun run build:bridge
cargo build --release
./target/release/poke-around
```
**Manual download**
Download the latest archive for your platform from [Releases](https://github.com/undivisible/poke-around/releases), extract it, and place `poke-around` plus `poke-around-bridge.js` in the same directory.
On macOS, if the binary is blocked by Gatekeeper:
```bash
xattr -cr poke-around
```
## Usage
```bash
poke-around # start the daemon (opens browser for OAuth on first run)
poke-around --verbose # show tool calls in real time
poke-around --mode limited
poke-around --mode sandbox
```
Config is stored at `~/.config/poke-around/config.json`.
## Access modes
| Mode | Description |
|------|-------------|
| **full** (default) | All tools, no approval required. |
| **limited** | Read-only tools plus a curated set of safe commands (`ls`, `cat`, `grep`, `curl`, etc.). |
| **sandbox** | Broader command support, but writes restricted to `~/Downloads` and `/tmp`. |
```bash
poke-around --mode sandbox
# or
POKE_GATE_PERMISSION_MODE=limited poke-around
```
## Running as a service
**macOS (Homebrew)**
```bash
brew services start poke-around
```
**Linux (systemd)**
```ini
# ~/.config/systemd/user/poke-around.service
[Unit]
Description=Poke Around Daemon
After=network.target
[Service]
ExecStart=%h/.local/bin/poke-around
Restart=always
[Install]
WantedBy=default.target
```
```bash
systemctl --user daemon-reload
systemctl --user enable --now poke-around
```
## Agents
Agents are scheduled JS scripts in `~/.config/poke-around/agents/` named `..js`:
| File | Runs |
|------|------|
| `beeper.1h.js` | every hour |
| `health.10m.js` | every 10 minutes |
Minimum interval is 10 minutes. Agents can import the `poke` SDK and send messages back via `poke.sendMessage(...)`.
```javascript
import { Poke, getToken } from "poke";
const poke = new Poke({ apiKey: getToken() });
await poke.sendMessage("Hello from my agent!");
```
Per-agent secrets go in `~/.config/poke-around/agents/.env.`.
## Security
In **full mode**, Poke Around grants full shell access to your Poke agent. Only run it on machines and networks you trust. Use `limited` or `sandbox` mode for tighter restrictions.
See [SECURITY.md](SECURITY.md) for the vulnerability disclosure policy.
## Credits
- Rust rewrite of [f/poke-gate](https://github.com/f/poke-gate)
- macOS computer-use primitives through [rs_peekaboo](https://github.com/undivisible/rs_peekaboo)
- [Poke](https://poke.com) by [The Interaction Company](https://interaction.co)
## License
MPL-2.0