Episoda CLI

Command-line tool for Episoda local development workflow orchestration.

Installation

From npm (recommended)

npm install -g episoda

For local development

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:

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 <module> - Create worktree for a module
• episoda release <module> - 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).