Config

Configuration

wa uses environment variables for per-machine customization.

Environment Variables

Variable	Default	Description
CASEMGR_URL	https://casemgr.systems/mcp	CaseMgr MCP server URL
CASEMGR_EMAIL	—	Pre-fill login email (skips prompt)
CASEMGR_PASSWORD	—	Pre-fill login password (skips prompt)
CASEMGR_TOKEN	—	Override stored auth token
WORKAREAS_DIR	~/.workareas	Base directory for wa data
WORKAREAS_WORKSPACE_DIR	~/.workareas/workspaces	Directory for VS Code workspace files

View Current Configuration

wa ls cfg

# Output:
# Configuration (derived from environment):
#   WORKAREAS_DIR:           /home/user/.workareas
#   WORKAREAS_WORKSPACE_DIR: /home/user/.workareas/workspaces

Custom CaseMgr Server

Point wa at a local development server:

# Temporary (current session)
CASEMGR_URL=http://localhost:4080/mcp wa ls wt

# Permanent (add to shell profile)
export CASEMGR_URL=http://localhost:4080/mcp

Authentication

wa stores its auth token at ~/.config/casemgr/token with restrictive permissions (600).

# Interactive login
wa login

# Non-interactive login (CI/scripts)
CASEMGR_EMAIL=user@example.com CASEMGR_PASSWORD=secret wa login

# Check auth status
wa whoami

# Clear token
wa logout

Data Backup & Restore

# Export current machine's workareas
wa export wa > backup.json

# Export all machines
wa export wa --all > backup_all.json

# Import on a new machine
wa import wa --file=backup.json

Directory Structure

~/.workareas/
└── workspaces/              # VS Code workspace files
    ├── project-a.code-workspace
    ├── project-b.code-workspace
    └── ...

~/.config/
├── casemgr/
│   └── token               # Auth token (600 permissions)
└── wa/
    ├── workarea-functions.sh  # Core shell functions
    ├── git-helpers.sh         # Git shortcuts
    └── project-functions.sh   # Project navigation examples