@generativereality/cctabs 0.2.0 → 0.3.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.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "cctabs",
3
3
  "description": "Claude Code tab manager. Terminal tabs as the UI, no tmux. Claude can orchestrate its own sibling sessions.",
4
- "version": "0.2.0",
4
+ "version": "0.3.1",
5
5
  "author": {
6
6
  "name": "generativereality",
7
7
  "url": "https://cctabs.com"
package/README.md CHANGED
@@ -67,15 +67,17 @@ curl -fsSL https://raw.githubusercontent.com/generativereality/cctabs/main/skill
67
67
  ## Usage
68
68
 
69
69
  ```
70
- cctabs sessions what's running (active/idle status)
70
+ cctabs sessions [--json] what's running (active/idle status)
71
71
  cctabs list all workspaces, tabs, and blocks
72
72
  cctabs new <name> [dir] [-w workspace] open tab, start claude
73
+ cctabs new <name> [dir] -r <session-id> open tab, resume an existing session by ID
73
74
  cctabs resume <name> [dir] open tab, run claude --continue
74
75
  cctabs fork <tab> [-n new-name] fork a session into a new tab
75
76
  cctabs close <tab> close a tab
76
77
  cctabs rename <tab> <new-name> rename a tab
77
78
  cctabs scrollback <tab> [lines] read terminal output (default: 50 lines)
78
- cctabs send <tab> [text] send input — arg, --file, or stdin pipe
79
+ cctabs send <tab> [text] [--wait-for-prompt] send input — arg, --file, or stdin pipe
80
+ cctabs restore [--manifest <file|->] [--create-missing] reattach or spawn from a manifest
79
81
  cctabs config show config path and values
80
82
  ```
81
83
 
@@ -114,6 +116,31 @@ cctabs scrollback auth # last 50 lines
114
116
  cctabs scrollback auth 200 # last 200 lines
115
117
  ```
116
118
 
119
+ ### Resume a specific session in a new tab
120
+
121
+ ```bash
122
+ # Useful when multiple sessions share the same dir — pass the exact session ID
123
+ cctabs new auth ~/Dev/myapp -r 19aae7b4-1234-…
124
+
125
+ # Combines with --worktree to resume inside an existing worktree
126
+ cctabs new auth ~/Dev/myapp -W -r 19aae7b4-…
127
+ ```
128
+
129
+ `cctabs resume <name>` is the right tool when there's only one session for a dir. Use `cctabs new ... --resume` when you need to disambiguate by session ID.
130
+
131
+ ### Migrate a fleet between terminals
132
+
133
+ ```bash
134
+ # On the source terminal, dump everything as a manifest
135
+ cctabs sessions --json > /tmp/fleet.json
136
+
137
+ # On the destination terminal, attach to any existing tabs and spawn the rest
138
+ cctabs restore --manifest /tmp/fleet.json --create-missing
139
+
140
+ # Or pipe directly
141
+ cctabs sessions --json | cctabs restore --manifest - --create-missing
142
+ ```
143
+
117
144
  ### Fork a session
118
145
 
119
146
  ```bash