codebyplan 1.4.3 → 1.5.1

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.
Files changed (3) hide show
  1. package/README.md +48 -5
  2. package/dist/cli.js +671 -2240
  3. package/package.json +2 -1
package/README.md CHANGED
@@ -12,7 +12,7 @@ This will:
12
12
 
13
13
  1. Prompt for your API key (get one at [codebyplan.com/settings/api-keys](https://codebyplan.com/settings/api-keys))
14
14
  2. Configure Claude Code to connect via remote MCP
15
- 3. Optionally link a repository and run the first sync
15
+ 3. Optionally link a repository
16
16
 
17
17
  ## Commands
18
18
 
@@ -20,9 +20,28 @@ This will:
20
20
 
21
21
  Interactive setup wizard. Configures your API key and MCP server connection.
22
22
 
23
- ### `codebyplan sync`
23
+ ### `codebyplan config`
24
24
 
25
- Bidirectional sync of `.claude/` infrastructure files between your local project and the CodeByPlan database.
25
+ Sync repo configuration from the CodeByPlan database to `.codebyplan.json`. Updates `server_port`, `server_type`, `branch_config`, and `port_allocations`. Also runs the worktree self-heal to cache the active worktree ID in memory.
26
+
27
+ **Options:**
28
+
29
+ | Flag | Description |
30
+ | ------------------ | ------------------------------------------------ |
31
+ | `--path <dir>` | Project root directory (default: cwd) |
32
+ | `--repo-id <uuid>` | Repository ID (default: from `.codebyplan.json`) |
33
+ | `--dry-run` | Preview changes without writing |
34
+
35
+ **Example:**
36
+
37
+ ```bash
38
+ codebyplan config
39
+ codebyplan config --dry-run
40
+ ```
41
+
42
+ ### `codebyplan ports`
43
+
44
+ Verify port allocations match local `package.json` dev scripts. Reports mismatches and unallocated apps. With `--fix`, auto-creates missing port allocations in the database.
26
45
 
27
46
  **Options:**
28
47
 
@@ -31,10 +50,34 @@ Bidirectional sync of `.claude/` infrastructure files between your local project
31
50
  | `--path <dir>` | Project root directory (default: cwd) |
32
51
  | `--repo-id <uuid>` | Repository ID (default: from `.codebyplan.json`) |
33
52
  | `--dry-run` | Preview changes without writing |
34
- | `--force` | Skip confirmation and conflict prompts |
35
53
  | `--fix` | Auto-create missing port allocations |
36
54
 
37
- **Side effects:** writes `worktree_id` (UUID) at the top level of `.codebyplan.json`, used as a cached scope for workflow skills. See `.claude/rules/worktree-tagging.md`.
55
+ **Example:**
56
+
57
+ ```bash
58
+ codebyplan ports
59
+ codebyplan ports --fix
60
+ codebyplan ports --fix --dry-run
61
+ ```
62
+
63
+ ### `codebyplan tech-stack`
64
+
65
+ Detect and sync tech stack dependencies from all `package.json` files in the project. Also runs the local config migration to move any legacy `worktree_id` from `.codebyplan.json` to the gitignored `.codebyplan.local.json`.
66
+
67
+ **Options:**
68
+
69
+ | Flag | Description |
70
+ | ------------------ | ------------------------------------------------ |
71
+ | `--path <dir>` | Project root directory (default: cwd) |
72
+ | `--repo-id <uuid>` | Repository ID (default: from `.codebyplan.json`) |
73
+ | `--dry-run` | Preview changes without writing |
74
+
75
+ **Example:**
76
+
77
+ ```bash
78
+ codebyplan tech-stack
79
+ codebyplan tech-stack --dry-run
80
+ ```
38
81
 
39
82
  ### `codebyplan help`
40
83