@atika-ai/bridge-desktop
v0.1.20
Published
Atika Bridge — connect a local machine to Atika so cloud agents can read/write files and run scripts inside approved project folders.
Maintainers
Readme
Atika Bridge Desktop
Small local daemon/CLI that connects a user-owned desktop to Atika through an outbound WebSocket. It does not run an LLM agent locally. It exposes controlled project capabilities: allowed folders, file operations, shell execution, runtime inventory, local audit events, and approval-required responses for risky commands.
Commands
pnpm build
pnpm dev -- init --gateway http://localhost:3010 --token dev-token
pnpm dev -- add-project atika ~/repos/atika
pnpm dev -- list-projects
pnpm dev -- run-shell atika pnpm test
pnpm dev -- connectThe Bridge stores config at ~/.atika/bridge-desktop/config.json unless
ATIKA_BRIDGE_CONFIG is set.
The WebSocket broker endpoint defaults to /api/v1/bridge/ws on the configured
gateway. The current repo does not implement that gateway endpoint yet; this
package is the app-side implementation.
Tauri Shell
The native shell lives in src-tauri and wraps the existing Bridge daemon. It
provides a small status window and tray hooks for starting/stopping the daemon,
checking service status, generating pairing codes, approving pending actions,
and managing the project allowlist.
pnpm tauri:dev
pnpm tauri:buildRust/Cargo and Tauri prerequisites are required for those commands. The shell
bundles the current Node runtime plus the built Bridge daemon into the .app
resources before tauri dev/build. Set ATIKA_BRIDGE_DESKTOP_CLI to point the
shell at another installed Bridge CLI during development.
App-local smoke test
This does not touch the Atika platform. It starts a lightweight mock broker, initializes a temporary Bridge config, connects the Bridge app outbound, sends operations to it, and verifies the responses.
pnpm smokeThe same mock broker can be used manually:
pnpm mock-broker
ATIKA_BRIDGE_CONFIG=/tmp/atika-bridge.json pnpm dev -- connectThe smoke test covers:
- outbound WebSocket connection
bridge.hello- project list/read/write/edit
- shell execution
- generated script execution
- approval-required response for risky shell
- local approval UI resume path
- persistent audit log entries
