@indigoai-us/hq-cli 5.164.0 → 5.166.0

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 ## [Unreleased]
 
+## [5.166.0] — 2026-09-24
+
+### Changed
+
+- The setup bot can explain what HQ is: the shared context layer for a whole
+  team, their coding tools (Claude Code, Codex, Cursor) and every bot. It no
+  longer repeats the finish card in replies after setup ends.
+
+## [5.165.0] — 2026-09-24
+
+### Fixed
+
+- Codex lane starts and resumes now pass the assigned worker policy directory to
+  policy hooks.
+
 ## [5.164.0] — 2026-09-24
 
 ### Fixed

package/assets/bot-workers/setup/worker.yaml

@@ -178,16 +178,69 @@ instructions: |
   it, and carry on with the next step. Never restart the walkthrough because
   you cannot remember it. Read the note first.
 
-  ## What HQ is, and how you make them feel it
-
-  HQ is one shared layer of context for a whole team. Everything that lands
-  in it (a connected tool, a call transcript, a profile, a client home, a
-  decision) is there for every teammate AND for every teammate's AI, whichever
-  coding tool they use. Their bots, a colleague's Claude Code, the new hire's
-  Cursor: all of them start every conversation already knowing the company,
-  the clients, the tools and the history. Nobody re-explains anything twice.
-  That is the point of setup, and the person should feel it, not be told it
-  once in a paragraph.
+  ## What HQ is
+
+  Know this well enough to explain it in your own words at any moment,
+  because people will ask ("what is HQ?", "how do I use it?", "why not just
+  use Claude?"), and a vague answer is the fastest way to lose them.
+
+  HQ is the shared context layer for a whole team and every AI that works
+  for it. A company's knowledge, people, clients, projects, decisions,
+  meeting notes, connected apps, keys and skills live in one place, and
+  everything that does work reads from it and writes back to it:
+
+  - Every person on the team. Their HQ folder syncs through HQ Cloud, so what
+    one person adds, every teammate has.
+  - Every AI tool they already use. Claude Code, Codex and Cursor open the
+    same HQ folder, so whichever tool someone prefers, it starts already
+    knowing the company. HQ does not replace those tools; it is what they all
+    share.
+  - Every bot. Bots on someone's Mac, bots in HQ Cloud, bots in Slack and
+    scheduled bots all start from the same context and can use the same
+    connected apps and skills.
+
+  What that changes for them: nobody explains the company twice, to a new
+  hire or to an AI. A call summarised on Monday is something any teammate's
+  bot can quote on Tuesday. A skill one person builds, everyone can run. When
+  a new person joins, their AI knows the business on day one. Each company is
+  kept separate: what belongs to one company never leaks into another, even
+  for someone who works in several.
+
+  Day to day, people use HQ by working the way they already do, in their
+  coding tool or by messaging bots here, and letting HQ carry the context.
+  They ask questions ("what did Lumen say about pricing last week?"), hand
+  work to bots, and add to it simply by connecting tools, recording meetings
+  and saving what they learn.
+
+  HQ is not an alternative to Claude, Codex or Cursor. Those are the tools
+  that do the thinking, and HQ is what they think with: Claude Code opened in
+  the HQ folder is Claude that already knows the company. So when someone
+  asks "how is this different from Claude?", the answer is that they keep
+  using Claude, and HQ is what makes Claude (and every teammate's AI, and
+  every bot) start from their business instead of from zero.
+
+  When someone asks what HQ is, answer in two or three plain sentences of
+  prose built from the above, then make it concrete with one thing from their
+  own HQ (a connected tool, a teammate, a client, a meeting). No bullet list,
+  no feature tour, no "short version" line. End on that concrete example, not
+  on an offer or a question about what to set up next. This holds even when
+  setup is unfinished: answering the question is the whole message, and the
+  walkthrough resumes on their next message, not in this one.
+
+  An answer that follows these rules reads like this:
+
+  > HQ is the shared memory that Claude Code, Codex and Cursor work from.
+  > You keep using Claude Code; opened in your HQ folder, it already knows
+  > your clients, your calls and what your team decided, and so does every
+  > teammate's AI and every bot. Your Fireflies calls are in there now, so
+  > anyone you add to Enabled AI can ask what a client said last week.
+
+  ## How you make them feel it
+
+  Everything that lands in HQ (a connected tool, a call transcript, a
+  profile, a client home, a decision) is there for every teammate AND for
+  every teammate's AI, whichever coding tool they use. That is the point of
+  setup, and the person should feel it, not be told it once in a paragraph.
 
   So make it visible as you go, in one clause, whenever something joins HQ:
 
@@ -540,7 +593,9 @@ instructions: |
   text at the end of the nicest message you will ever send them.
 
   Send it once, in this closing message only (and in the one you send when
-  they say "skip").
+  they say "skip"). Never put it in any later message, including a short
+  reply to "ok" or "thanks" after the closing message: the card is already
+  there, and the person replying is what puts it away.
 
   Then write `Status: finished` in your progress note.
 

package/dist/lib/lanes/spawn.d.ts

@@ -222,6 +222,8 @@ export declare function buildProviderCommand(provider: LaneProvider, input: {
     fastMode?: boolean;
     /** Per-spawn worker profile instructions and materialized settings. */
     profile?: ProviderProfileLaunch;
+    /** Worker profile path, forwarded to Codex hook subprocesses when supported. */
+    workerPolicyDir?: string;
     /** Continue a recorded session. Only providers in PROVIDER_SESSION_RESUME accept this. */
     resume?: ProviderResumeInput;
     /**

package/dist/lib/lanes/spawn.js

@@ -522,6 +522,19 @@ function appendProviderProfileFlags(provider, args, profile) {
         }
     }
 }
+/** Make the worker policy directory available to Codex hook subprocesses. */
+function appendCodexWorkerPolicyDirFlag(provider, args, workerPolicyDir) {
+    if (provider !== "codex" || workerPolicyDir === undefined)
+        return args;
+    if (!workerPolicyDir.trim()) {
+        throw new LanesError("invalid_worker_policy_dir", "Worker policy directory must not be empty");
+    }
+    const setting = `shell_environment_policy.set.HQ_POLICY_WORKER_DIR=${JSON.stringify(workerPolicyDir)}`;
+    const separator = args.indexOf("--");
+    if (separator === -1)
+        return [...args, "-c", setting];
+    return [...args.slice(0, separator), "-c", setting, ...args.slice(separator)];
+}
 export const PID_LIVENESS_DECISIONS = [
     "esrch",
     "starttime_mismatch",
@@ -1138,7 +1151,7 @@ export function buildProviderCommand(provider, input) {
     }
     return {
         command,
-        args: appendFastModeFlags(parsed, appendEffortFlag(parsed, appendModelFlag(parsed, appendProviderProfileFlags(parsed, args, input.profile), input.model), input.effort), input.fastMode),
+        args: appendFastModeFlags(parsed, appendEffortFlag(parsed, appendModelFlag(parsed, appendCodexWorkerPolicyDirFlag(parsed, appendProviderProfileFlags(parsed, args, input.profile), input.workerPolicyDir), input.model), input.effort), input.fastMode),
     };
 }
 export function workerEnv(base, resolved, laneId, hqRoot, autoCompactTokens, meshCompany, workerPolicyDir) {
@@ -1757,6 +1770,7 @@ export function spawnLaneWorker(hqRoot, lane, deps = {}, launch = {}) {
         effort: effort.effort,
         fastMode,
         profile: profileLaunch,
+        workerPolicyDir,
         resume,
     });
     // A systemd PATH mismatch is an environment defect, not a lane failure.
@@ -1806,6 +1820,7 @@ export function spawnLaneWorker(hqRoot, lane, deps = {}, launch = {}) {
                 effort: effort.effort,
                 fastMode,
                 profile: profileLaunch,
+                workerPolicyDir,
                 resume: { session_id: resume.session_id, prompt: COMPACTION_PROMPT },
             });
             compaction = compactLaneSession({
@@ -2128,6 +2143,7 @@ export function spawnEnvelopeRepair(hqRoot, lane, input, deps = {}) {
         effort: effort.effort,
         fastMode,
         profile: profileLaunch,
+        workerPolicyDir,
         ...(mode === "resume" && sessionId !== null
             ? { resume: { session_id: sessionId, prompt: repairPrompt } }
             : { freshTurnPrompt: repairPrompt }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.164.0",
+  "version": "5.166.0",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {