@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 +48 -0
- package/dist/daemon/daemon-process.d.ts +2 -0
- package/dist/daemon/daemon-process.js +13751 -0
- package/dist/daemon/daemon-process.js.map +1 -0
- package/dist/hooks/post-checkout +327 -0
- package/dist/hooks/post-commit +137 -0
- package/dist/hooks/pre-commit +140 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.js +7670 -0
- package/dist/index.js.map +1 -0
- package/package.json +62 -0
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).
|