Setup Wizard
Genie includes an interactive setup wizard that configures your environment step by step. Run it with:
Or skip interactive prompts with sensible defaults:
The wizard walks through several sections, each configurable independently:
1. System Check
Before configuration, setup verifies prerequisites:
tmux is required — there is no fallback. If tmux is not installed, agent spawning will fail.
2. Session Configuration
Configure the default tmux session:
3. Terminal Configuration
Configure terminal behavior:
4. Codex Integration
If Codex is detected, setup configures the OpenTelemetry bridge:
This writes the Codex OTel config to enable structured log output that Genie’s transcript system can parse.
5. Keyboard Shortcuts
Install tmux and shell shortcuts for quick access:
Section-Specific Setup
Run only the section you need:
Showing Current Config
View the current configuration without making changes:
Resetting Configuration
Reset all settings to defaults:
This deletes ~/.genie/config.json and re-creates it with default values.
Post-Setup Verification
After setup, verify your installation with the doctor command:
Doctor checks:
- All required binaries are available
- tmux server is running
- Configuration file is valid
- pgserve can start
- Git hooks are installed (if applicable)
Config File Location
Setup creates and manages ~/.genie/config.json. See Configuration Files for the full schema.
