wa CLI

Install

curl -fsSL https://casemgr.systems/cli/install.sh | bash click to copy

Requires Erlang/OTP runtime. Linux and macOS supported.
Need an account? Sign up free

Getting Started

Authenticate

wa login

List your worktrees

wa ls wt                  # local worktrees
wa ls wt --server          # all machines

Create a worktree with alias

wa add --bn=feature-x --alias=fx

Navigate and code

cdwa fx                   # cd to worktree by alias
wa code                    # open VS Code
home                       # back to worktree root

Commands

Worktrees

Command	Description
`wa ls wt`	List local worktrees
`wa ls wt --server`	List all worktrees (all machines)
`wa add --bn=branch --alias=name`	Create worktree with branch and alias
`wa get wt --worktree`	Get current worktree root path
`wa get wt --case`	Show case linked to current worktree
`wa set wt --alias=name`	Set alias for current worktree
`wa rm wt --wt=path`	Remove a worktree
`wa code`	Open VS Code workspace for current worktree

Aliases & Navigation

Command	Description
`wa ls wa --aliases`	List all aliases
`wa get wa --alias=name`	Get worktree path by alias (fuzzy matching)
`wa set wa --alias=name`	Set alias for current workarea
`wa export wa`	Export workareas as JSON
`wa import wa --file=backup.json`	Import workareas from backup

Branches

Command	Description
`wa ls br`	List branches
`wa co br --bn=main`	Checkout a branch
`wa co br --bn=feature-x --b`	Create and checkout new branch

Cases

Command	Description
`wa ls case`	List all cases
`wa ls case --caseStatus=active`	Filter by status
`wa add case --caseName="My Case"`	Create a new case
`wa get case --caseId=#7:123`	Get case details
`wa set wt --assignCase="Case Name"`	Link current worktree to a case (by name)

File Operations

Command	Description
`wa upload report.pdf`	Upload file to case (auto-resolved)
`wa upload doc.pdf --caseId=#7:123`	Upload to specific case
`wa download report.pdf`	Download file from case
`wa move invoice.pdf`	Upload, verify (SHA-256), delete local

MCP Passthrough

Call any of CaseMgr's 150+ MCP tools directly from the command line. Output is JSON.

wa mcp cases.list                          # list all cases
wa mcp cases.list status=active              # filter by status
wa mcp items.list case_id="#7:123"            # list items in a case
wa mcp items.semantic_search query="invoice"  # semantic search
wa mcp preferences.get                       # user preferences

Authentication

Command	Description
`wa login`	Authenticate with CaseMgr
`wa logout`	Clear stored token
`wa whoami`	Show current user

Shell Helpers

The installer adds shell functions to your profile for interactive use:

Function	Description
`cdwa <alias>`	Navigate to worktree by alias
`codewa <alias>`	Navigate and open VS Code
`home`	Navigate to current worktree root
`main`	Checkout the main branch
`aliases`	List all worktree aliases

Additional git helpers and project navigation examples are installed to ~/.config/wa/.

Environment Variables

Variable	Default	Purpose
`CASEMGR_URL`	`https://casemgr.systems/mcp`	MCP server URL
`CASEMGR_EMAIL`	—	Pre-fill login email
`CASEMGR_PASSWORD`	—	Pre-fill login password
`CASEMGR_TOKEN`	—	Override stored auth token
`WORKAREAS_DIR`	`~/.workareas`	Base data directory
`WORKAREAS_WORKSPACE_DIR`	`~/.workareas/workspaces`	VS Code workspace files