{"id":47764887,"url":"https://github.com/undivisible/poke-around","last_synced_at":"2026-06-08T07:01:55.578Z","repository":{"id":348418925,"uuid":"1197995068","full_name":"undivisible/poke-around","owner":"undivisible","description":"let poke use your computer, with macos, linux and windows support.","archived":false,"fork":false,"pushed_at":"2026-06-06T06:44:13.000Z","size":8144,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-06T07:02:19.203Z","etag":null,"topics":["ai-agent","automation","computer-use","mcp","poke","remote-control","rs-peekaboo","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/undivisible.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-01T03:21:55.000Z","updated_at":"2026-06-06T06:44:16.000Z","dependencies_parsed_at":"2026-06-06T07:00:21.931Z","dependency_job_id":null,"html_url":"https://github.com/undivisible/poke-around","commit_stats":null,"previous_names":["undivisible/poke-around"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/undivisible/poke-around","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/undivisible%2Fpoke-around","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/undivisible%2Fpoke-around/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/undivisible%2Fpoke-around/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/undivisible%2Fpoke-around/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/undivisible","download_url":"https://codeload.github.com/undivisible/poke-around/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/undivisible%2Fpoke-around/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34051772,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-08T02:00:07.615Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","automation","computer-use","mcp","poke","remote-control","rs-peekaboo","rust"],"created_at":"2026-04-03T06:01:15.998Z","updated_at":"2026-06-08T07:01:55.529Z","avatar_url":"https://github.com/undivisible.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Poke Around\n\nLet your [Poke](https://poke.com) AI assistant access your machine.\n\n\u003csub\u003eA community project — not affiliated with Poke or The Interaction Company.\u003c/sub\u003e\n\n[![Latest Release](https://img.shields.io/github/v/release/undivisible/poke-around?style=flat-square)](https://github.com/undivisible/poke-around/releases/latest)\n[![License](https://img.shields.io/github/license/undivisible/poke-around?style=flat-square)](https://github.com/undivisible/poke-around/blob/main/LICENSE)\n![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux-blue?style=flat-square)\n\n---\n\nRun 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.\n\n## Install\n\n**Install script (macOS / Linux)**\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/undivisible/poke-around/main/scripts/install.sh | bash\n```\n\n**Homebrew (macOS / Linux)**\n\n```bash\nbrew tap undivisible/tap\nbrew install poke-around\n```\n\nIf install fails at **`brew link`** for **`simdjson`** (a dependency of Homebrew **node**), your prefix still has an older simdjson linked. Unlink it, then retry:\n\n```bash\nbrew unlink simdjson\nbrew install poke-around\n```\n\nIf 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`.\n\n**Build from source**\n\nRequires stable [Rust](https://www.rust-lang.org/tools/install) and [Bun](https://bun.sh):\n\n```bash\ngit clone https://github.com/undivisible/poke-around.git\ncd poke-around\nbun run build:bridge\ncargo build --release\n./target/release/poke-around\n```\n\n**Manual download**\n\nDownload 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.\n\nOn macOS, if the binary is blocked by Gatekeeper:\n\n```bash\nxattr -cr poke-around\n```\n\n## Usage\n\n```bash\npoke-around          # start the daemon (opens browser for OAuth on first run)\npoke-around --verbose  # show tool calls in real time\npoke-around --mode limited\npoke-around --mode sandbox\n```\n\nConfig is stored at `~/.config/poke-around/config.json`.\n\n## Access modes\n\n| Mode | Description |\n|------|-------------|\n| **full** (default) | All tools, no approval required. |\n| **limited** | Read-only tools plus a curated set of safe commands (`ls`, `cat`, `grep`, `curl`, etc.). |\n| **sandbox** | Broader command support, but writes restricted to `~/Downloads` and `/tmp`. |\n\n```bash\npoke-around --mode sandbox\n# or\nPOKE_GATE_PERMISSION_MODE=limited poke-around\n```\n\n## Running as a service\n\n**macOS (Homebrew)**\n\n```bash\nbrew services start poke-around\n```\n\n**Linux (systemd)**\n\n```ini\n# ~/.config/systemd/user/poke-around.service\n[Unit]\nDescription=Poke Around Daemon\nAfter=network.target\n\n[Service]\nExecStart=%h/.local/bin/poke-around\nRestart=always\n\n[Install]\nWantedBy=default.target\n```\n\n```bash\nsystemctl --user daemon-reload\nsystemctl --user enable --now poke-around\n```\n\n## Agents\n\nAgents are scheduled JS scripts in `~/.config/poke-around/agents/` named `\u003cname\u003e.\u003cinterval\u003e.js`:\n\n| File | Runs |\n|------|------|\n| `beeper.1h.js` | every hour |\n| `health.10m.js` | every 10 minutes |\n\nMinimum interval is 10 minutes. Agents can import the `poke` SDK and send messages back via `poke.sendMessage(...)`.\n\n```javascript\nimport { Poke, getToken } from \"poke\";\nconst poke = new Poke({ apiKey: getToken() });\nawait poke.sendMessage(\"Hello from my agent!\");\n```\n\nPer-agent secrets go in `~/.config/poke-around/agents/.env.\u003cname\u003e`.\n\n## Security\n\nIn **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.\n\nSee [SECURITY.md](SECURITY.md) for the vulnerability disclosure policy.\n\n## Credits\n\n- Rust rewrite of [f/poke-gate](https://github.com/f/poke-gate)\n- macOS computer-use primitives through [rs_peekaboo](https://github.com/undivisible/rs_peekaboo)\n- [Poke](https://poke.com) by [The Interaction Company](https://interaction.co)\n\n## License\n\nMPL-2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fundivisible%2Fpoke-around","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fundivisible%2Fpoke-around","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fundivisible%2Fpoke-around/lists"}