@botcord/daemon 0.2.2 → 0.2.3

package/dist/gateway/runtimes/claude-code.js

@@ -76,6 +76,12 @@ export class ClaudeCodeAdapter extends NdjsonStreamAdapter {
     }
     buildArgs(opts) {
         const args = ["-p", opts.text, "--output-format", "stream-json", "--verbose"];
+        // Headless `-p` mode does not load project `.claude/` by default, so
+        // per-agent skills seeded at `<workspace>/.claude/skills/` are invisible
+        // unless we opt in. `extraArgs` wins so operators can still override.
+        if (!opts.extraArgs?.some((a) => a.startsWith("--setting-sources"))) {
+            args.push("--setting-sources", "project");
+        }
         if (opts.sessionId) {
             if (!isValidClaudeSessionId(opts.sessionId))
                 throw new Error(invalidClaudeSessionIdError());

package/dist/index.js

@@ -34,15 +34,18 @@ Commands:
                                           Without --agent, the daemon discovers
                                           identities from ~/.botcord/credentials
                                           at startup (repeat --agent to pin).
-  start [--foreground] [--relogin] [--hub <url>] [--label <name>]
-                                          Start the daemon. Without credentials
-                                          and on a TTY, runs the interactive
-                                          device-code login first. --hub defaults
-                                          to ${DEFAULT_HUB} (or the URL stored in
-                                          a previous login). --relogin forces
-                                          re-login. --label is sent to the Hub
-                                          on connect for the dashboard device
-                                          list (defaults to hostname). Non-TTY
+  start [--background|-d] [--relogin] [--hub <url>] [--label <name>]
+                                          Start the daemon in the foreground by
+                                          default. Pass --background (alias -d)
+                                          to detach and return to the shell.
+                                          Without credentials and on a TTY, runs
+                                          the interactive device-code login
+                                          first. --hub defaults to ${DEFAULT_HUB}
+                                          (or the URL stored in a previous
+                                          login). --relogin forces re-login.
+                                          --label is sent to the Hub on connect
+                                          for the dashboard device list
+                                          (defaults to hostname). Non-TTY
                                           environments must mount a pre-existing
                                           user-auth.json (plan §6.4).
   stop                                    Stop the running daemon (SIGTERM)
@@ -79,6 +82,8 @@ Env:
 /** Known boolean flags — never consume the following token as a value. */
 const BOOLEAN_FLAGS = new Set([
     "foreground",
+    "background",
+    "d",
     "f",
     "follow",
     "json",
@@ -285,9 +290,12 @@ async function ensureUserAuthForStart(args) {
 }
 async function cmdStart(args) {
     const cfg = loadConfig();
-    const foreground = args.flags.foreground === true;
+    // Foreground is now the default. --background (alias -d) detaches.
+    // --foreground is still accepted (no-op) for backwards compatibility and
+    // is also what the detached child re-execs itself with.
+    const background = args.flags.background === true || args.flags.d === true;
     log.info("cmd start", {
-        foreground,
+        background,
         relogin: args.flags.relogin === true,
         child: process.env.BOTCORD_DAEMON_CHILD === "1",
     });
@@ -304,7 +312,7 @@ async function cmdStart(args) {
     if (process.env.BOTCORD_DAEMON_CHILD !== "1") {
         await ensureUserAuthForStart(args);
     }
-    if (!foreground) {
+    if (background) {
         // Detached child re-exec in foreground mode. The child writes the PID
         // file once it's up; the parent only polls to confirm startup so the
         // two never race on the same file.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botcord/daemon",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "BotCord local daemon — bridges Hub inbox push to local Claude Code / Codex / Gemini CLIs",
   "type": "module",
   "bin": {

package/src/gateway/runtimes/claude-code.ts

@@ -96,6 +96,12 @@ export class ClaudeCodeAdapter extends NdjsonStreamAdapter {
 
   protected buildArgs(opts: RuntimeRunOptions): string[] {
     const args = ["-p", opts.text, "--output-format", "stream-json", "--verbose"];
+    // Headless `-p` mode does not load project `.claude/` by default, so
+    // per-agent skills seeded at `<workspace>/.claude/skills/` are invisible
+    // unless we opt in. `extraArgs` wins so operators can still override.
+    if (!opts.extraArgs?.some((a) => a.startsWith("--setting-sources"))) {
+      args.push("--setting-sources", "project");
+    }
     if (opts.sessionId) {
       if (!isValidClaudeSessionId(opts.sessionId)) throw new Error(invalidClaudeSessionIdError());
       args.push("--resume", opts.sessionId);

package/src/index.ts

@@ -74,15 +74,18 @@ Commands:
                                           Without --agent, the daemon discovers
                                           identities from ~/.botcord/credentials
                                           at startup (repeat --agent to pin).
-  start [--foreground] [--relogin] [--hub <url>] [--label <name>]
-                                          Start the daemon. Without credentials
-                                          and on a TTY, runs the interactive
-                                          device-code login first. --hub defaults
-                                          to ${DEFAULT_HUB} (or the URL stored in
-                                          a previous login). --relogin forces
-                                          re-login. --label is sent to the Hub
-                                          on connect for the dashboard device
-                                          list (defaults to hostname). Non-TTY
+  start [--background|-d] [--relogin] [--hub <url>] [--label <name>]
+                                          Start the daemon in the foreground by
+                                          default. Pass --background (alias -d)
+                                          to detach and return to the shell.
+                                          Without credentials and on a TTY, runs
+                                          the interactive device-code login
+                                          first. --hub defaults to ${DEFAULT_HUB}
+                                          (or the URL stored in a previous
+                                          login). --relogin forces re-login.
+                                          --label is sent to the Hub on connect
+                                          for the dashboard device list
+                                          (defaults to hostname). Non-TTY
                                           environments must mount a pre-existing
                                           user-auth.json (plan §6.4).
   stop                                    Stop the running daemon (SIGTERM)
@@ -128,6 +131,8 @@ interface ParsedArgs {
 /** Known boolean flags — never consume the following token as a value. */
 const BOOLEAN_FLAGS = new Set([
   "foreground",
+  "background",
+  "d",
   "f",
   "follow",
   "json",
@@ -363,9 +368,13 @@ async function ensureUserAuthForStart(args: ParsedArgs): Promise<UserAuthRecord
 
 async function cmdStart(args: ParsedArgs): Promise<void> {
   const cfg = loadConfig();
-  const foreground = args.flags.foreground === true;
+  // Foreground is now the default. --background (alias -d) detaches.
+  // --foreground is still accepted (no-op) for backwards compatibility and
+  // is also what the detached child re-execs itself with.
+  const background =
+    args.flags.background === true || args.flags.d === true;
   log.info("cmd start", {
-    foreground,
+    background,
     relogin: args.flags.relogin === true,
     child: process.env.BOTCORD_DAEMON_CHILD === "1",
   });
@@ -385,7 +394,7 @@ async function cmdStart(args: ParsedArgs): Promise<void> {
     await ensureUserAuthForStart(args);
   }
 
-  if (!foreground) {
+  if (background) {
     // Detached child re-exec in foreground mode. The child writes the PID
     // file once it's up; the parent only polls to confirm startup so the
     // two never race on the same file.