Workflows

This page lists the intended command palette. Some commands are aspirational until their queue item lands; the workflow shape is the contract.

Personal command palette

Run navi from a managed shell to browse repo-owned cheatsheets. Bash, Fish, and PowerShell set NAVI_PATH to:

~/.config/navi/cheats

Useful entry points:

navi
navi --print
navi --query "git worktree"
navi --print --query "docs build" --best-match

Managed categories cover WSL path conversion, CachyOS maintenance, Git worktrees, Codex and Claude modes, Yazi shortcuts, Scoop/mise diagnostics, notes, HTTP/API, and docs maintenance. The notes entries require NOTES_DIR; they do not create or choose a notes location.

Daily commands

Command	Intent
navi	Browse the personal command palette and cheatsheets.
p	Pick or enter a project.
p t	Open or attach a tmux session for a project.
p e	Open a project in the editor.
p y	Open a project in Yazi.
p g	Open a project in lazygit.
p c	Open a project in Codex.
p cl / p claude	Open a project in Claude through claude-env.
p w	Choose a project worktree.
p w add <branch>	Create a sibling worktree for a branch.
p w pr <pr>	Create a sibling worktree for a GitHub PR.
p w e|y|g|t|c|cl <query>	Open a selected worktree in editor, Yazi, lazygit, tmux, Codex, or Claude.
p w rm <query>	Remove a clean, non-current worktree.
cx	Run Codex in the current repo.
cxi	Run Codex with the implementation profile.
cxr	Run Codex with the careful read/review profile.
cxd	Run Codex with the deep-review profile.
cxq	Run Codex with the quiet auto profile.
cxu	Run Codex with the ultra profile.
cxp	Pick a project, then run Codex there.
cxw	Pick a worktree, then run Codex there.
cla	Run Claude in the current repo through the managed Fish abbreviation.
pcl	Pick a project, then run Claude there.
wcl	Pick a worktree, then run Claude there.
lg	Open lazygit in the current repo.
y	Open Yazi in the current directory.
navi --query notes	Show notes commands that use NOTES_DIR.
note	Open the notes index.
today	Open the daily note.
scratch	Open the shared scratch note.
mdp	Preview Markdown or run a terminal presentation.
typ	Compile, watch, or format Typst.
diagram	Render Mermaid diagrams.
tldr <command>	Show short command examples.
ouch list <archive>	Inspect an archive without extracting it.
jless file.json	Browse JSON interactively.
numbat	Run unit-aware calculations.

Worktrees use sibling directories by default: branch feature/search in ~/code/app becomes ~/code/app-feature-search, and PR 123 becomes a ~/code/app-pr-123-... directory. Removal refuses dirty or current worktrees.

Workflow areas

• Project launcher: select repos, worktrees, and modes.
• Shell: prompt, history, completion, and editing behavior.
• Terminal: consistent font, theme, shell defaults, tabs, panes, and copy/paste behavior.
• Cross-platform wrappers: open, edit, clipboard, reveal, path conversion, and non-destructive trash commands.
• Git: CLI helpers, GitHub CLI aliases, lazygit commands, and worktrees.
• Editors: Zed and VS Code settings, extensions, keybindings, snippets, tasks, and build systems.
• Agent CLIs: Codex and Claude wrappers plus project selection that keep state on the right filesystem.
• Notes and writing: daily notes, scratch files, Markdown preview, Typst, presentations, and diagrams.
• HTTP/API: xh for one-offs and hurl for repeatable request files.
• Workstation tools: archives, JSON inspection, command examples, binary inspection, calculations, and terminal workspace evaluation.
• Maintenance: package-manager updates, mise policy, smoke tests, and rollback.