Jouzu command reference

Commands and shortcuts

Search verified user-facing slash commands, terminal commands and keyboard shortcuts. Open Jouzu and type /hotkeys to confirm what your terminal currently supports.

Beginner guide Jouzu repository

Quick reference

First session

/login shisa: Connect a Shisa AI account.
/model: Choose the model for this session.
/status: Show the active model, workspace and context use.
/hotkeys: List the shortcuts active in your terminal.

Everyday work

/voice: Start or stop voice dictation.
/settings: Open language, account, catalog and other settings.
Ctrl+L: Open the model picker.
/flow: Explain why automatic work is waiting or paused.

Agentic work

/workflow: Configure child-agent roles and inspect runs.
/goal <objective>: Keep one objective active until you pause, stop or finish it.
/multiloop: Inspect or set up measured, repeated work.
/bg: Open the background-job dashboard.

Troubleshooting

jz doctor: Check installation, runtime, catalogs and credentials without changing them.
/bug: Draft a public GitHub issue for you to review.
jz self-update status: Show how this installation receives updates.
/about: Compare the running and installed Jouzu builds.

97 entries

Basics

7 entries

/settingsBeginner

Open Jouzu settings.

/settings

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

/statusBeginner

Show the session, workspace, model, thinking level, context, profile and runtime.

/status

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/presentation.ts

/hotkeysBeginner

List the active keyboard shortcuts.

/hotkeys

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

/quitBeginner

Quit Jouzu.

/quit

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

/exitBeginner

Quit Jouzu. This exact alias uses the same exit path as /quit.

/exit

Verified source: shisa-ai/jouzu@781817ae · CHANGELOG.md v0.2.5

/aboutBeginner

Show running and installed Jouzu builds, the Pi version and startup time.

/about

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/model-picker.ts

/changelogIntermediate

Show release changelog entries.

/changelog

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

Accounts

4 entries

/logoutBeginner

Choose provider authentication to remove.

/logout

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

/logout shisaBeginner

Ask Shisa to revoke the key, then remove the local Shisa connection.

/logout shisa

Verified source: shisa-ai/jouzu@781817ae · docs/shisa.md

Models

6 entries

/model [provider/model]Beginner

Open the model picker, or select a model by exact provider/model.

Example

/model

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

/thinking [level]Intermediate

Set the thinking level supported by the active model.

Example

/thinking high

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

/scoped-modelsIntermediate

Choose the models included in interactive model cycling.

/scoped-models

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

/catalogsIntermediate

Open Settings at the model-catalog controls.

/catalogs

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/model-picker.ts

/fast [on|off]Intermediate

Show or change Fast processing for this session on eligible GPT Responses or Codex models.

Requirement: Only eligible models and accounts.

Example

/fast on

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/fast-mode.ts

/llamaAdvanced

Manage models on a configured llama.cpp router.

Requirement: Requires a configured llama.cpp router.

/llama

Verified source: shisa-ai/jouzu@781817ae · Pi dist/extensions/llama/index.js

Preferences

3 entries

/settings → LanguageBeginner

Preview and save interface, response and artifact languages.

Verified source: shisa-ai/jouzu@781817ae · docs/language.md

Inspect or change automatic session and tmux pane naming.

Example

/labels

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/session-labels.ts

/reloadIntermediate

Reload keybindings, extensions, skills, prompt templates, themes and context files.

/reload

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

Sessions

14 entries

/newBeginner

Start a new session.

/new

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

/resumeBeginner

Choose and resume another saved session.

/resume

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

/name [name]Beginner

Show or set the session display name.

Example

/name website tutorial

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

/sessionIntermediate

Show current session information and statistics.

/session

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

/treeIntermediate

Navigate the session tree and switch branches.

/tree

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

/forkAdvanced

Create a new session from an earlier user message.

/fork

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

/cloneAdvanced

Duplicate the current session at its current position.

/clone

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

/compact [instructions]Intermediate

Manually compact the active context, optionally with custom instructions.

Example

/compact

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

/scrollbackBeginner

Export the active conversation to terminal scrollback for search and selection.

/scrollback

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/scrollback.ts

/copyBeginner

Copy the last assistant message to the clipboard.

/copy

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

/export [path]Intermediate

Export the session as HTML or JSONL.

Example

/export session.html

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

/import <path>Advanced

Import a JSONL session while preserving its ID and working directory.

Example

/import session.jsonl

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

/trustAdvanced

Save the project trust decision for future sessions.

/trust

Verified source: shisa-ai/jouzu@781817ae · Pi dist/core/slash-commands.js

Voice

1 entries

Control microphone dictation. Stopping inserts text for you to review; it does not send the prompt.

Requirement: Requires /login shisa or SHISA_API_KEY with realtime speech access.

Example

/voice

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/voice/integration.ts

Tools

5 entries

/mcpAdvanced

Manage configured MCP servers, authentication, connection state and tool exposure.

Requirement: Available when MCP support is enabled.

/mcp

Verified source: shisa-ai/jouzu@781817ae · Pi dist/extensions/mcp/index.js

/textguard [on|strict|off|reports]Intermediate

Review flagged content, inspect reports or change scanning for this session.

Example

/textguard

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/textguard-review.ts

/tasks [auto|auto cascade|auto off|auto status]Intermediate

Open the task list, or control task auto-advance.

Example

/tasks

Verified source: shisa-ai/jouzu@781817ae · bundled @lhl/pi-tasks/src/index.ts

/code-preview-healthAdvanced

Show code-preview renderer health and settings.

/code-preview-health

Verified source: shisa-ai/jouzu@781817ae · bundled pi-code-previews/src/commands/health.ts

/code-preview-settingsAdvanced

Configure code-preview rendering.

/code-preview-settings

Verified source: shisa-ai/jouzu@781817ae · bundled pi-code-previews/src/commands/settings.ts

Agent workflows

2 entries

/workflow [on|off|toggle]Intermediate

Configure agent roles and inspect child runs, or enable and disable child execution for this session.

Example

/workflow

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/subagents/integration.ts

/subagents [show|hide]Intermediate

Open Workflow at Runs, or show and hide the child-agent dashboard.

/subagents [show|hide]

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/subagents/integration.ts

Automation

20 entries

/schedule-promptIntermediate

Open scheduled prompts and settings. Schedules fire only while a Jouzu session is open in that folder.

/schedule-prompt

Verified source: shisa-ai/jouzu@781817ae · bundled pi-schedule-prompt/src/index.ts

/goal [--tokens <N>] <objective>Intermediate

Start one persistent objective, or show active goals when no objective is supplied.

Example

/goal add tests for the parser

Verified source: shisa-ai/jouzu@781817ae · bundled pi-multiloop/extensions/pi-multiloop/index.ts

/goal <pause|resume|stop|clear> [lane/run-tag]Advanced

Pause, resume, stop or clear a goal.

Example

/goal pause

Verified source: shisa-ai/jouzu@781817ae · bundled pi-multiloop/README.md

Inspect, set up and control repeated measured work.

Example

/multiloop status

Verified source: shisa-ai/jouzu@781817ae · bundled pi-multiloop/extensions/pi-multiloop/index.ts

/bgIntermediate

Open the background-task dashboard.

/bg

Verified source: shisa-ai/jouzu@781817ae · bundled @vanillagreen/pi-background-tasks/extensions/registrations.ts

/bg:nextIntermediate

Send the next shell command to a background task.

/bg:next

Verified source: shisa-ai/jouzu@781817ae · bundled @vanillagreen/pi-background-tasks/extensions/registrations.ts

/bg:run <command>Intermediate

Start a shell command as a background task.

Example

/bg:run npm test

Verified source: shisa-ai/jouzu@781817ae · bundled @vanillagreen/pi-background-tasks/extensions/registrations.ts

/bg:listBeginner

List tracked background tasks.

/bg:list

Verified source: shisa-ai/jouzu@781817ae · bundled @vanillagreen/pi-background-tasks/extensions/registrations.ts

/bg log <id|pid>Intermediate

Show the end of a background task log.

/bg log <id|pid>

Verified source: shisa-ai/jouzu@781817ae · bundled @vanillagreen/pi-background-tasks/README.md

/bg watch <id|pid>Intermediate

Open the background dashboard focused on one task.

/bg watch <id|pid>

Verified source: shisa-ai/jouzu@781817ae · bundled @vanillagreen/pi-background-tasks/README.md

/bg:stop <id|pid>Intermediate

Stop a running background task.

/bg:stop <id|pid>

Verified source: shisa-ai/jouzu@781817ae · bundled @vanillagreen/pi-background-tasks/extensions/registrations.ts

/bg:clearIntermediate

Remove finished background tasks from the list.

/bg:clear

Verified source: shisa-ai/jouzu@781817ae · bundled @vanillagreen/pi-background-tasks/extensions/registrations.ts

/flow [details [page]|runtime]Intermediate

Show held, waiting and paused automatic work, with controls that can release it.

Example

/flow

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/flow-control/flow-status-extension.ts

/flow <on|off>Advanced

Turn flow control on or off for this session without stopping jobs.

/flow <on|off>

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/flow-control/flow-status-extension.ts

/flow <pause|resume>Intermediate

Pause or resume every automatic reply in this session.

/flow <pause|resume>

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/flow-control/flow-status-extension.ts

/flow <pause|resume|stop> <work>Advanced

Change one registered work item without stopping its underlying process.

/flow <pause|resume|stop> <work>

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/flow-control/flow-status-extension.ts

/flow <clear|reset|reset confirm>Advanced

Release a stuck reservation, or inspect and confirm a destructive flow reset.

/flow <clear|reset|reset confirm>

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/flow-control/flow-status-extension.ts

/flow retry <request>Advanced

Authorize one withheld model request to pass pre-send checks again.

/flow retry <request>

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/flow-control/flow-status-extension.ts

/flow cancel <token>Advanced

Cancel a wait gate. The underlying job keeps running.

/flow cancel <token>

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/flow-control/flow-status-extension.ts

/flow resolve <attempt> <retry|discard>Advanced

Resolve a model request whose delivery outcome is unknown.

/flow resolve <attempt> <retry|discard>

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/flow-control/flow-status-extension.ts

Diagnostics

6 entries

/bug [description]Beginner

Prepare a public GitHub issue draft. Review it for private information before submitting.

Example

/bug jz command not found after install

Verified source: shisa-ai/jouzu@781817ae · docs/bug-reporting.md

jz doctor [--json]Beginner

Run non-mutating installation, runtime, catalog and credential diagnostics.

Example

jz doctor

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/args.ts

jz --versionBeginner

Show Jouzu, Pi and profile-schema versions.

jz --version

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/args.ts

jz --helpBeginner

Show Jouzu command-line help.

jz --help

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/args.ts

jz self-update <status [--json]|check [--json]|apply>Intermediate

Inspect, check or apply an npm-installation update.

Requirement: Global npm installations. The Windows launcher has its own updater.

jz self-update <status [--json]|check [--json]|apply>

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/args.ts

jz self-update policy <auto-restart|notify|off>Intermediate

Set the startup update policy for a global npm installation.

Example

jz self-update policy notify

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/args.ts

Terminal CLI

15 entries

jzBeginner

Start Jouzu in the current folder.

jz

Verified source: shisa-ai/jouzu@781817ae · packages/cli/package.json

jz acpAdvanced

Serve Agent Client Protocol over standard input and output.

Requirement: For ACP host integrations.

jz acp

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/args.ts

jz catalog status [source-id] [--json]Advanced

Inspect model-catalog configuration and status.

jz catalog status [source-id] [--json]

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/args.ts

jz catalog refresh [source-id] [--json]Advanced

Refresh all model catalogs or one named source.

jz catalog refresh [source-id] [--json]

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/args.ts

jz catalog <accept|reject> <revision> --digest <sha256> [--source <source-id>]Advanced

Accept or reject a held catalog revision after matching its digest.

jz catalog <accept|reject> <revision> --digest <sha256> [--source <source-id>]

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/args.ts

jz catalog <validate|conformance> <file> [--json]Advanced

Validate a catalog file, optionally including conformance rules.

jz catalog <validate|conformance> <file> [--json]

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/args.ts

jz profile plan [--profile <core|ja>] [--json]Intermediate

Preview profile file changes without writing them.

jz profile plan [--profile <core|ja>] [--json]

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/args.ts

jz profile apply [--profile <core|ja>]Intermediate

Apply the selected profile with conflict checks and backups.

Example

jz profile apply --profile core

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/args.ts

jz profile-migration <plan [--json]|apply [--yes]|rollback>Advanced

Plan, apply or roll back migration from profile-based language choices.

jz profile-migration <plan [--json]|apply [--yes]|rollback>

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/args.ts

jz keybindings <status [--json]|plan [--json]|apply|reset>Intermediate

Inspect, preview, add or remove Jouzu-owned keybinding defaults.

jz keybindings <status [--json]|plan [--json]|apply|reset>

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/args.ts

jz --jouzu-home <path> …Advanced

Use one portable Jouzu configuration, state and cache root.

jz --jouzu-home <path> …

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/args.ts

jz --jouzu-profile <core|ja> …Advanced

Select a profile for this launch.

jz --jouzu-profile <core|ja> …

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/args.ts

jz --jouzu-ui-locale <auto|en|ja|zh-Hans|zh-Hant> …Advanced

Request a startup UI locale when no saved choice overrides it.

jz --jouzu-ui-locale <auto|en|ja|zh-Hans|zh-Hant> …

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/args.ts

jz [--jouzu-textguard-strict|--jouzu-textguard-off|--jouzu-textguard-files] …Advanced

Change TextGuard scanning for one launch.

jz [--jouzu-textguard-strict|--jouzu-textguard-off|--jouzu-textguard-files] …

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/args.ts

jz <pi|--> [Pi arguments…]Advanced

Pass the remaining arguments explicitly to Jouzu’s pinned Pi runtime.

Example

jz pi --help

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/args.ts

Shortcuts

14 entries

Ctrl+LBeginner

Open the model picker.

Verified source: shisa-ai/jouzu@781817ae · Pi docs/keybindings.md

Ctrl+P / Shift+Ctrl+PBeginner

Cycle forward or backward through selected favorite models.

Verified source: shisa-ai/jouzu@781817ae · Pi docs/keybindings.md

Shift+TabBeginner

Cycle the active model’s thinking level.

Verified source: shisa-ai/jouzu@781817ae · Pi docs/keybindings.md

Ctrl+SIntermediate

Save the selected model or current thinking level as a default in the active picker.

Verified source: shisa-ai/jouzu@781817ae · Pi docs/keybindings.md

Ctrl+/ / Ctrl+?Beginner

Open the Jouzu help overlay.

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/help.ts

Ctrl+\Beginner

Start or stop voice dictation.

Requirement: Requires Shisa realtime speech access.

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/jouzu-keybindings.ts

Ctrl+EnterIntermediate

Queue editor text as a follow-up while the agent is working.

Requirement: Requires modified-Enter support in the terminal.

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/keybindings.ts

Ctrl+UpIntermediate

Restore queued messages to the editor.

Requirement: May conflict with macOS Mission Control and needs modified-arrow reporting.

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/keybindings.ts

Ctrl+FIntermediate

In Models, toggle the selected model as a favorite.

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/jouzu-keybindings.ts

Ctrl+Shift+RIntermediate

In Models, refresh model catalogs and providers.

Requirement: Some terminals require enhanced keyboard reporting; use R in Settings / Catalogs if needed.

Verified source: shisa-ai/jouzu@781817ae · packages/cli/src/jouzu-keybindings.ts

Enter / Shift+EnterBeginner

Send the prompt, or insert a new line.

Verified source: shisa-ai/jouzu@781817ae · Pi docs/keybindings.md

EscBeginner

Cancel the active operation or close a selection.

Verified source: shisa-ai/jouzu@781817ae · Pi docs/keybindings.md

Ctrl+OIntermediate

Collapse or expand tool output.

Verified source: shisa-ai/jouzu@781817ae · Pi docs/keybindings.md

Ctrl+XIntermediate

Copy the selected message or the last assistant message, depending on the active view.

Verified source: shisa-ai/jouzu@781817ae · Pi docs/keybindings.md