Genie

Code on the go — control AI coding agents from your phone, browser, or terminal.

Free. Open source. Code anywhere.

Installation

npm install -g genie

Migrated from the genie-coder package. Thanks to @franciscop for donating the genie package name!

Usage

Claude Code (default)

genie
# or
genie claude

This will:

1. Start a Claude Code session
2. Display a QR code to connect from your mobile device or browser
3. Allow real-time session control — all communication is end-to-end encrypted
4. Start new sessions directly from your phone or web while your computer is online

More agents

genie codex
genie gemini
genie openclaw

# or any ACP-compatible CLI
genie acp opencode
genie acp -- custom-agent --flag

Daemon

The daemon is a background service that stays running on your machine. It lets you spawn and manage coding sessions remotely — from your phone or the web app — without needing an open terminal.

genie daemon start
genie daemon stop
genie daemon status
genie daemon list

The daemon starts automatically when you run genie, so you usually don't need to manage it manually.

Authentication

genie auth login
genie auth logout

Genie uses cryptographic key pairs for authentication — your private key stays on your machine. All session data is end-to-end encrypted before leaving your device.

To connect third-party agent APIs:

genie connect gemini
genie connect claude
genie connect codex
genie connect status

Commands

| Command | Description | |---------|-------------| | genie | Start Claude Code session (default) | | genie codex | Start Codex mode | | genie gemini | Start Gemini CLI session | | genie openclaw | Start OpenClaw session | | genie acp | Start any ACP-compatible agent | | genie resume <id> | Resume a previous session | | genie notify | Send push notification to your devices | | genie doctor | Diagnostics & troubleshooting |

Screen Sharing Audio

Browser WebRTC screen sharing can request display audio:

genie screen --webrtc --audio

For the later meeting-transcription path, the publisher can also save Opus/WebM audio chunks locally:

genie screen --webrtc --audio-ingest

Chunks are written to ~/.genie/screen/audio-ingest/. Browser system-audio capture depends on Chrome and the host audio stack; Linux/VNC setups may need a later PulseAudio/PipeWire ffmpeg fallback.

Advanced

Environment Variables

| Variable | Description | |----------|-------------| | GENIE_SERVER_URL | Custom server URL (default: https://api.cluster-fluster.com) | | GENIE_WEBAPP_URL | Custom web app URL (default: https://app.genie.engineering) | | GENIE_HOME_DIR | Custom home directory for Genie data (default: ~/.genie) | | GENIE_DISABLE_CAFFEINATE | Disable macOS sleep prevention | | GENIE_EXPERIMENTAL | Enable experimental features |

Sandbox (experimental)

Genie can run agents inside an OS-level sandbox to restrict file system and network access.

genie sandbox configure
genie sandbox status
genie sandbox disable

Building from source

git clone https://github.com/slopus/genie
cd genie-cli
yarn install
yarn workspace genie cli --help

Requirements

• Node.js >= 20.0.0
• For Claude: claude CLI installed & logged in
• For Codex: codex CLI installed & logged in
• For Gemini: npm install -g @google/gemini-cli + genie connect gemini

License

MIT