migasrias2/geckobox

选用指南

AI 根据 README 整理 · 2026/10/21 19:11:32

使用方式

通过命令行工具或SDK使用，提供本地网页仪表盘。

查看 README 依据

 **➜ Full step-by-step guide: [docs/TUTORIAL.md](docs/TUTORIAL.md)** ## The app ```sh npm install -g github:migasrias2/geckobox openspaces ui ``` A local dashboard opens in your browser: dark, green, rounded and calm, inspired by Grok Bot's layout (bots on the left, the conversation in the middle, the bot's computer live on the right). - **New thread:** pick an agent and a computer, say what to do, and it runs in the background.

- **Computers:** create sandboxes, add SSH, Docker or Cua machines, check which agents each has, and watch any desktop live. - **"Let it use computers (Cua)"** pre-approves only Cua's tools on your Mac (Claude Code `--allowedTools mcp__cua`), so an agent can drive a sandbox's browser without approving everything. It runs on `127.0.0.1` only, behind a random token in the link the command prints, and it rejects other hosts, so other websites can't drive it.  ## SDK in ten lines ```ts import { startThread } from "openspaces"

部署要求

需要Node.js和npm，目标机器需安装代理CLI，支持macOS、SSH、Docker等。

查看 README 依据

 **➜ Full step-by-step guide: [docs/TUTORIAL.md](docs/TUTORIAL.md)** ## The app ```sh npm install -g github:migasrias2/geckobox openspaces ui ``` A local dashboard opens in your browser: dark, green, rounded and calm, inspired by Grok Bot's layout (bots on the left, the conversation in the middle, the bot's computer live on the right). - **New thread:** pick an agent and a computer, say what to do, and it runs in the background.

brew install container && container system start # macOS 26: Apple's open-source runtime (or use Docker/Podman) openspaces sandbox create dev # ~20 s: an isolated Linux VM with Claude Code installed openspaces start --on dev "clone my repo and fix the failing test" ```

A **thread** is one agent conversation on one computer. Each turn runs the agent headless in its own work dir on that computer (`~/.openspaces/work/<thread>`). The agent's session id is saved, so the next message resumes the same conversation. Thread state lives in `~/.openspaces/threads/` on the machine you drive it from. There is nothing to install on the target except the agent CLI itself. No daemon, no account, no relay. ## Agents - `claude-code`: `claude -p --output-format stream-json`, resumed with `--resume`. **Tested live.**

已知限制

暂无托管中继、分享链接、团队角色、原生应用，部分代理适配器未经实机测试。

查看 README 依据

- `shell`: the prompt is a shell script; good for jobs and smoke tests. **Tested live.** - `codex`: `codex exec --json`, resumed with `codex exec resume`. Written from the CLI docs, not yet live-tested. - `gemini`: `gemini -p --output-format stream-json`, resumed with `--resume`. Not yet live-tested. - `opencode`: `opencode run --format json`, resumed with `--session`. Not yet live-tested. Adding an agent is one small file: build its argv and map its output lines to events (`src/agents/`). PRs welcome, especially live-tested fixes for the three untested adapters. ## CLI ```sh

- **Hosted relay:** use Tailscale (free for personal use) or plain SSH instead. - **Share links and team roles:** add teammates as SSH users, or share the machine on your tailnet. - **Saved sign-ins (keyvault, teleport):** not yet. - **A native Mac and iPhone app:** not yet. The dashboard is a local web app (`openspaces ui`). ## Develop ```sh npm install npm test # unit, in-process threads, the HTTP API, and the built CLI end to end npm run dev:ui # UI with hot reload (proxying to `openspaces ui --port 4600`) npm run typecheck ``` ## License MIT © Miguel Fortes Martins