Episoda CLI

Command-line tool for Episoda local development workflow orchestration.

Installation

$3

``bash
npm install -g episoda
`

$3

When developing the CLI locally, use npm run install-global instead of npm link. This copies files rather than creating symlinks, so the CLI survives worktree removal:

`bash
cd packages/episoda
npm run install-global
`

> Why not npm link? Using npm link creates a symlink to the worktree directory. When that worktree is removed (after merge), the CLI breaks. The install-global script uses npm pack + npm install -g to copy files instead.

Commands

- episoda auth - Authenticate with Episoda
- episoda dev - Connect project to Episoda daemon
- episoda status - Show connection status
- episoda checkout - Create worktree for a module
- episoda release - Remove worktree after merge
- episoda list - Show active worktrees

Auto-Updates

The CLI automatically checks for updates when you run episoda status`. If a new version is available, it will be installed automatically.

For file-linked development installs, auto-update is skipped (shows "linked" in version output).