CLI-Only Commands

These commands are exclusive to the terminal CLI interface. They are not available in the Web UI, Telegram bot, or Discord bot -- they rely on the local terminal process and have no server-side equivalent. If you try to use them from a non-CLI channel, they will be silently ignored or return an error.

Command Reference

/version

Prints the installed CLI-JAW version, build hash, and runtime information to the terminal. Useful for bug reports and verifying that an update succeeded.

Syntax

/version

Arguments

None. This command takes no arguments or flags.

Output

cli-jaw v2.14.0 (build a3f8c1d)
node: v22.11.0 | platform: darwin-arm64
config: ~/.cli-jaw/config.yaml

Example Usage

# Check your version before reporting an issue
/version

# Pipe to clipboard (in your shell, not inside a jaw session)
jaw --version | pbcopy

/quit, /q

Gracefully shuts down the CLI-JAW process. This saves the current conversation to the session log, flushes any pending memory writes, and exits the Node.js process with code 0. /q is a short alias that behaves identically.

Syntax

/quit
/q

Arguments

None. This command takes no arguments or flags.

Behavior

• Session save -- The current conversation is persisted to ~/.cli-jaw/sessions/ so it can be resumed later with /session load.
• Memory flush -- Any in-flight memory writes are committed before exit.
• Clean exit -- The process exits with code 0. If something blocks exit for more than 5 seconds, the process force-terminates.
• No confirmation -- The command exits immediately without prompting "are you sure?"

Example Usage

# End the session
/quit

# Same thing, shorter
/q

/file

Attaches a local file to the current conversation context. The file is read from disk and injected into the message history as a hidden attachment -- it does not render visually in the terminal output, but the AI model receives its full content. This is useful for feeding documents, images, or data files into the conversation without cluttering the display.

Syntax

/file <path> [caption]

Arguments

Supported File Types

Behavior

• Hidden attachment -- The file content is added to the AI context but not printed to the terminal. This keeps the display clean when attaching large files.
• Size limit -- Files exceeding the model's context window are truncated with a warning. For very large files, consider splitting or summarizing first.
• Relative paths -- Resolved relative to the current working directory (the directory from which you launched jaw).
• Binary files -- Images and documents are base64-encoded. Unsupported binary formats produce an error.

Example Usage

# Attach a source file for review
/file src/auth/middleware.ts Review this middleware for security issues

# Attach a screenshot for analysis
/file ~/Desktop/screenshot.png What error is shown here?

# Attach a CSV for data analysis
/file ./sales-q4.csv

# Attach a PDF document
/file ~/Documents/contract.pdf 이 계약서 요약해줘

/ide

Controls the IDE diff view panel. When enabled, code changes proposed by the assistant are displayed in a side-by-side or unified diff format similar to VS Code's diff editor, rather than inline in the chat. This makes it easier to review multi-file changes before accepting them.

Syntax

/ide <mode>

Arguments

Modes Explained

• pop -- Spawns a separate terminal window dedicated to showing diffs. Best for multi-monitor setups where you want the diff always visible alongside the chat. The pop-out window updates in real time as the assistant proposes changes.
• on -- Splits the current terminal vertically. The top half shows the conversation; the bottom half shows the active diff. Works in any terminal but reduces available chat space.
• off -- Returns to the default behavior where code blocks and diffs are rendered inline in the conversation stream.

Terminal Requirements

Example Usage

# Open diff view in a separate window
/ide pop

# Enable inline diff view
/ide on

# Turn off diff view
/ide off

# Typical workflow: enable diff, ask for changes, review
/ide on
"이 함수 리팩터링해줘 -- async/await으로 바꿔줘"
# Review the diff in the panel, then accept or reject

Platform Availability

The table below clarifies where each command works and where it does not:

* Electron desktop app includes an embedded terminal that supports CLI-only commands. The Web UI served via browser does not.

Troubleshooting

/file says "file not found"

Check that the path is correct relative to the directory where you launched jaw. Use an absolute path if unsure:

# Instead of relative path
/file ./data/report.csv

# Use absolute path
/file /Users/jun/projects/data/report.csv

/ide pop does nothing

The pop mode requires iTerm2, Wezterm, or tmux. If you are using a different terminal emulator (Terminal.app, Alacritty, Hyper), the command silently falls back to on mode. Check your terminal:

echo $TERM_PROGRAM
# Should output: iTerm.app, WezTerm, or tmux

/quit hangs

If /quit does not exit within 5 seconds, there may be a pending network request or file write. Press Ctrl+C to force-kill the process. Check ~/.cli-jaw/sessions/ to verify the session was saved.