ethos-cli 0.1.4 → 0.1.6

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ethos-cli",
3
- "version": "0.1.4",
3
+ "version": "0.1.6",
4
4
  "description": "Commander-based CLI for Ethos table operations",
5
5
  "homepage": "https://github.com/cluster-software/ethos#readme",
6
6
  "repository": {
@@ -11,11 +11,11 @@ pass `--api-url` for local development or an explicitly requested environment.
11
11
 
12
12
  ## Flow
13
13
 
14
- Always keep CSV upload browser-first:
14
+ Always keep CSV upload in the Codex in-app Browser:
15
15
 
16
- 1. Open Ethos in the browser with the CSV upload deep link.
16
+ 1. Open Ethos in the in-app Browser with the CSV upload deep link.
17
17
  2. Immediately ask the user for ICP, buying signals, person targets, and max contacts while they upload.
18
- 3. Poll the browser URL until the upload-complete URL appears.
18
+ 3. Poll that same in-app Browser tab until the upload-complete URL appears.
19
19
  4. Save the uploaded table id from that URL.
20
20
  5. Create the `people_sourcing` agent and Codex-created column with the CLI.
21
21
  6. Run the column for the FIRST 3 ROWS ONLY. Tell the user you're running for 3 rows to see if the results are good. If yes, the next step is to run on the whole table. If not, refine the agent based on their feedback so it finds the right people.
@@ -43,7 +43,7 @@ the user explicitly wants a non-browser setup.
43
43
 
44
44
  ## Open Browser Upload
45
45
 
46
- Open this URL in the browser:
46
+ Open this URL in the Codex in-app Browser:
47
47
 
48
48
  ```sh
49
49
  APP_BASE_URL="https://ethos.hello-cluster.com"
@@ -53,7 +53,9 @@ if [ -n "${CODEX_THREAD_ID:-}" ]; then
53
53
  fi
54
54
  ```
55
55
 
56
- Run `open "$UPLOAD_URL"` and tell the user to upload the CSV there.
56
+ Use the Browser plugin/in-app Browser to navigate to `$UPLOAD_URL` and tell
57
+ the user to upload the CSV there. Do not use `open`, Chrome, Safari, or any
58
+ external/default browser for this flow.
57
59
 
58
60
  After opening the upload modal, immediately ask:
59
61
 
@@ -61,7 +63,7 @@ After opening the upload modal, immediately ask:
61
63
  Please describe your ICP, any signals that would make them a good fit for your product or service, and where that data may live. You can keep typing while the CSV uploads.
62
64
  ```
63
65
 
64
- Then poll the browser URL every 2 seconds while the user uploads and answers.
66
+ Then poll the in-app Browser URL every 2 seconds while the user uploads and answers.
65
67
  The ONLY upload-completion indicator is this URL shape:
66
68
 
67
69
  ```text
@@ -165,22 +167,21 @@ Only run the agent for 3 rows on the first run, so the user can give feedback.
165
167
 
166
168
  ## Keep Browser On The Table
167
169
 
168
- After the `source-people` command succeeds, bring the browser back to the table:
170
+ ONLY IF the user is not already viewing the table when the `source-people` command succeeds, bring the browser back to the table:
169
171
 
170
172
  ```sh
171
173
  "$APP_BASE_URL/tables/$TABLE_ID"
172
174
  ```
173
175
 
174
- The table UI should hide the upload return modal once the Codex-created column
175
- appears, then auto-scroll to that column.
176
-
177
- Then report the table URL, run id, and agent id. Keep the response concise and
178
- mention that the Codex-created column should appear and auto-scroll into view in
179
- Ethos.
176
+ Then tell the user the agent is running on the first 3 rows. Do not surface
177
+ agent ids, run ids, table ids, or similar internal ids unless the user asks for
178
+ them or you are actively debugging.
180
179
 
181
180
  ## How to communicate with the user
182
181
 
183
- While you execute the flow, keep communication with the user simple and approachable at all times. Do not mention internal ethos concepts unless explicitly necessary.
182
+ - While you execute the flow, keep communication simple and approachable. Avoid
183
+ explaining UI behavior that should happen automatically when everything is
184
+ working. Do not mention internal Ethos concepts unless explicitly necessary.
184
185
 
185
186
  For example, instead of
186
187
 
@@ -190,9 +191,14 @@ say
190
191
 
191
192
  "I’ll create an agent to find people with those criteria, then run it only on the first 3 rows so you can judge the results before expanding. Give me a second to set it up, you will see the agent start working in ethos soon."
192
193
 
193
- If you need input from the user, make it very clear by bolding it and maybe mentioning it on a new line.
194
+ Or instead of
195
+
196
+ "I found the row selector for the trial run, so I can keep this to the first 3 companies exactly. I’m creating the agent now with the B2B seed/Series A GTM criteria and 4-contact target."
197
+
198
+ say "I'm creating the agent now with the B2B seed/Series A GTM criteria and 4-contact target."
199
+
200
+ - If you need input from the user, make it very clear by bolding it and maybe mentioning it on a new line.
194
201
 
195
202
  E.g.:
196
203
 
197
204
  "**Next, please give me the following information** ..."
198
-