Quickstart

Install CLI-JAW and start your first AI agent session in under 5 minutes.

Prerequisites

Node.js 20+ — nodejs.org
npm (comes with Node.js)
An active subscription to at least one AI CLI (e.g., Claude Pro or higher for Claude Code, ChatGPT Pro or higher for Codex, Google AI for Gemini CLI)

Installation

macOS / Linux

npm install -g cli-jaw

Windows

Windows requires WSL (Windows Subsystem for Linux). Install WSL first, then open Ubuntu from the Start menu and run the commands there.

# In WSL Ubuntu terminal:
npm install -g cli-jaw

Detailed Windows guide: Windows Setup

Initial Setup

jaw init

The setup wizard will guide you through:

Choosing your primary CLI (Claude Code, Codex, Gemini CLI, etc.)
Authenticating your CLI subscription
Configuring the server port (default: 3457)

CLI Authentication

Each CLI authenticates through its own subscription. Run the CLI login command in a separate terminal:

# Claude Code (requires Claude Pro subscription or higher)
claude

# Codex (requires ChatGPT Pro subscription or higher)
codex

# Gemini CLI (requires Google AI subscription)
gemini

Default premium models are claude-opus-4-8 for Claude and gpt-5.5 for Codex. Starting in June, choose claude-e when you want to use the Claude allowance bundled with your subscription.

Then set your preferred CLI in jaw:

jaw init   # or /cli claude in chat

API keys in settings.json are only needed for advanced features like voice (Gemini API) or image generation (OpenAI API). The main CLI auth is handled by each tool's own login.

Verify Installation

jaw doctor

This checks your setup and reports any issues.

Troubleshooting

Error	Fix
`command not found: jaw`	Ensure npm global bin is in your PATH. Run `npm bin -g` to find it.
`EACCES permission denied`	Use `sudo npm install -g cli-jaw` or fix npm permissions.
`node: command not found`	Install Node.js 20+ from nodejs.org

Try it:

jaw init 하고 CLI 인증하면 끝
jaw doctor로 설치 확인해줘

Overview First Run