@episoda/cli 0.2.144

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md ADDED
@@ -0,0 +1,48 @@
1
+ # @episoda/cli
2
+
3
+ Command-line tool for Episoda local development workflow orchestration.
4
+
5
+ > **Note:** This package was previously published as `episoda`. It has been renamed to `@episoda/cli` for org-level ownership (EP1326). The `episoda` command name is unchanged.
6
+
7
+ ## Installation
8
+
9
+ ### From npm (recommended)
10
+
11
+ ```bash
12
+ npm install -g @episoda/cli
13
+ ```
14
+
15
+ ### Migrating from `episoda`
16
+
17
+ If you previously installed the unscoped `episoda` package:
18
+
19
+ ```bash
20
+ npm uninstall -g episoda
21
+ npm install -g @episoda/cli
22
+ ```
23
+
24
+ ### For local development
25
+
26
+ 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:
27
+
28
+ ```bash
29
+ cd packages/episoda
30
+ npm run install-global
31
+ ```
32
+
33
+ > **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.
34
+
35
+ ## Commands
36
+
37
+ - `episoda auth` - Authenticate with Episoda
38
+ - `episoda dev` - Connect project to Episoda daemon
39
+ - `episoda status` - Show connection status
40
+ - `episoda checkout <module>` - Create worktree for a module
41
+ - `episoda release <module>` - Remove worktree after merge
42
+ - `episoda list` - Show active worktrees
43
+
44
+ ## Auto-Updates
45
+
46
+ The CLI automatically checks for updates when you run `episoda status`. If a new version is available, it will be installed automatically.
47
+
48
+ For file-linked development installs, auto-update is skipped (shows "linked" in version output).
@@ -0,0 +1,2 @@
1
+
2
+ export { }