Files in the latest version

.gitignore

LICENSE

README.md

benchmark/test-cu.js

benchmark/test-gaps.js

benchmark/test-reasoning-permissions.js

benchmark/userdata-fixed/sessions/20260909_100940_e44a45.jsonl

benchmark/userdata-fixed/sessions/20260909_101026_1ec1bf.jsonl

benchmark/userdata-fixed/sessions/20260909_102638_81b127.jsonl

benchmark/userdata-fixed/sessions/20260909_102752_5098a8.jsonl

index.html

native/VoxUia.cs

package-lock.json

package.json

resources/icon.ico

resources/icon.png

resources/skills/codeberg/SKILL.md

resources/skills/coderook/SKILL.md

resources/skills/computer-use/SKILL.md

resources/skills/github/SKILL.md

resources/skills/gitlab/SKILL.md

resources/skills/preview-browser/SKILL.md

resources/skills/service-setup/SKILL.md

resources/uia/voxai-uia.exe

resources/update-key.pem

scripts/auto-battery.js

scripts/build-uia.js

scripts/clean-release.js

scripts/csp.js

scripts/make-icon.js

scripts/probe-maximise.js

scripts/probe-page.js

scripts/probe-preview.js

scripts/probe-steer.js

scripts/release-key.js

scripts/release.js

scripts/verify-steer-live.js

scripts/verify-steer.js

src/backend/agent.js

src/backend/background.js

src/backend/commands.js

src/backend/compact.js

src/backend/costs.js

src/backend/cu/cdp.js

src/backend/cu/desktop.js

src/backend/cu/index.js

src/backend/cu/linux-input.js

src/backend/cu/linux-native.js

src/backend/cu/linux-uia.js

src/backend/cu/native.js

src/backend/cu/uia.js

src/backend/cu/win-input.js

src/backend/goal.js

src/backend/providers/openrouter.js

src/backend/sessions.js

src/backend/team.js

src/backend/tools/agents.js

src/backend/tools/artifact.js

src/backend/tools/browser.js

src/backend/tools/build_state.js

src/backend/tools/checkpoints.js

src/backend/tools/decode.js

src/backend/tools/docrag.js

src/backend/tools/eol.js

src/backend/tools/freshness.js

src/backend/tools/fsops.js

src/backend/tools/index.js

src/backend/tools/kills.js

src/backend/tools/lsp.js

src/backend/tools/mcp.js

src/backend/tools/memory.js

src/backend/tools/node_repl.js

src/backend/tools/patch.js

src/backend/tools/procs.js

src/backend/tools/rag.js

src/backend/tools/sandbox.js

src/backend/tools/skills.js

src/backend/tools/snapshot.js

src/backend/tools/spawn.js

src/backend/tools/terminal.js

src/backend/tools/verify.js

src/backend/tools/web_fetch.js

src/backend/tools/web_search.js

src/backend/tools/worktree.js

src/main/attention.js

src/main/interactive.js

src/main/local-engine.js

src/main/main.js

src/main/split.js

src/main/terminal.js

src/main/updater.js

src/preload/notice-preload.js

src/preload/preload.js

src/renderer/index.html

src/renderer/notice.html

src/renderer/notice.js

src/renderer/terminal-panel.js

src/renderer/vendor/vte.browser.js

src/renderer/vendor/xterm-addon-fit.js

src/renderer/vendor/xterm.css

src/renderer/vendor/xterm.js

steer-test.js

test-e2e.js

test/regression-protocol.js

test/regression-refit.js

test/regression-renderer.js

test/regression-sessions.js

test/regression-tools.js

README

VoxAI Coder

A desktop coding agent (Electron) that bills through your OpenRouter key.
Own backend (no external agent binaries), enforced workdir sandbox, Vox Text
Engine rendering, and a growing power-tool surface for caching, memory, and
project handling.

Quick start

npm start

Settings → paste OpenRouter key (and optionally a management key for account
credits) → Save → pick a model → send a message.

Architecture

src/main/main.js — Electron main: settings/keychain, sessions, agent orchestration, OpenRouter account usage, model catalog, IPC.
src/preload/preload.js — context-isolated bridge (window.voxai.*).
src/backend/agent.js — tool-calling loop (streams tokens live via onLiveEvent, executes tools, yields UI events).
src/backend/providers/openrouter.js — SSE streaming provider with include_usage_cost + stream_options.include_usage.
src/backend/sessions.js — JSONL per-session store.
src/backend/compact.js — conversation compactor (auto-summarizes long sessions into a [VOX COMPACTED CONTEXT] recap, keeps recent messages).
src/backend/tools/ — the tool surface (see below).
src/backend/cu/ — Computer Use: a persistent Chrome/Edge CDP browser backend (cdp.js), a native Windows controller (native.js), and the agent tool surface (index.js).
src/renderer/ — Forge-styled UI; Vox Text Engine (vendor/vte.browser.js) filters leaks, normalizes markdown, and drives the typewriter reveal.

Tool surface (42)

Tool	Purpose
read / write / edit / patch	Files. `patch` applies exact old→new edits atomically (cheap, safe).
glob / grep	Search.
shell	Commands (permission-gated).
todo	Running UI task list.
memory	Durable per-project facts in `.voxai/memory.json` (add/list/search/forget).
rag	Keyword retrieval over large files (>12k chars), chunk sidecars under `.voxai/rag/`.
worktree	Git worktree isolation (create/status/merge/discard) under `.voxai/wt/`.
web_fetch	https-only research fetch (permission-gated).
lsp	Fast diagnostics: tsc / `node --check` / py_compile / JSON.parse.
snapshot	Session + workspace snapshots (create/list/restore) in userData.
node_repl	Pure-JS VM sandbox (no fs/network/require) for quick code checks.
mcp_list_tools / mcp_call	Model Context Protocol stdio client (configure servers in settings `mcpServers`).
skills_list / skill_load	Load skills from `~/.codex/skills` + `~/.claude/skills` (Cloudflare, sandbox, wrangler, …).
stat / mkdir / move / remove / search	Filesystem parity (AI_GUI workspace_* equivalents).
doc_rag	Document RAG: txt/md/pdf/docx/xlsx → chunk → keyword retrieve (dependency-free).
spawn_agent	Nested sub-agent for parallel exploration (own sub-session, isolated, persisted).
browser_open / browser_act / browser_screenshot	Drive a hidden Electron BrowserWindow (runtime-gated).
cu_launch / cu_state / cu_click / cu_type / cu_press / cu_scroll / cu_screenshot / cu_list	Computer Use: read the live screen (text + indexed elements + screenshot streamed to the UI) and act on it — persistent Chrome/Edge via CDP, plus native Windows window control (Win32/.NET).
spawn_agent / spawn_parallel	Sub-agents now stream LIVE events into the main thread as collapsible inline cards (Claude/Codex style) — no separate tab needed.
Plan mode (chip toggle)	When ON, the agent explores first, presents a step-by-step plan, and calls ask_confirm — mutating tools are gated until you approve (Claude/Codex plan mode).
sandbox_status	Report access level, per-tool auto/prompt policy, worktree isolation.
artifact_publish	Publish reviewable artifacts (changed_file/log/screenshot/validation) with hash + UI event.

Concurrency & cost

Multiple sessions run in parallel; each owns its stream/run-card/token state.
Header shows session COST / TOKENS / $per-1M (Goose-style: catalog pricing fallback when OpenRouter omits real cost).

Roadmap / ideas

MCP client for external servers (stub exists).
Real git diff tab + preview pane from the original Forge concept.
Cloudflare skill integration (your installed skills are already in ~/.claude/skills / ~/.codex/skills).

PUBLIC REPOSITORY

Opening batty-251/voxai-coder-linux…

Loading the public version history and verified file tree.

batty-251/voxai-coder-linux

Versions