@codecell-germany/company-agent-wiki-skill 0.1.1 → 0.1.3

package/dist/installer.js

@@ -3470,6 +3470,7 @@ var {
 } = import_index.default;
 
 // src/lib/constants.ts
+var PACKAGE_NAME = "@codecell-germany/company-agent-wiki-skill";
 var CLI_NAME = "company-agent-wiki-cli";
 var INSTALLER_NAME = "company-agent-wiki-skill";
 var SKILL_NAME = "company-agent-wiki-cli";
@@ -3537,14 +3538,18 @@ exec "$NODE_BIN" "${runtimeScript}" "$@"
 `;
   import_node_fs2.default.writeFileSync(targetPath, content, { encoding: "utf8", mode: 493 });
 }
-function installIntoCodexHome(options) {
-  const packageRoot = resolvePackageRoot(__dirname);
-  const codexHome = options?.codexHome || process.env.CODEX_HOME || import_node_path.default.join(import_node_os.default.homedir(), ".codex");
-  const runtimeDir = import_node_path.default.join(codexHome, "tools", SKILL_NAME);
-  const skillDir = import_node_path.default.join(codexHome, "skills", SKILL_NAME);
-  const binDir = import_node_path.default.join(codexHome, "bin");
+function getDefaultAgentsHome() {
+  return process.env.AGENTS_HOME || import_node_path.default.join(import_node_os.default.homedir(), ".agents");
+}
+function getDefaultCodexHome() {
+  return process.env.CODEX_HOME || import_node_path.default.join(import_node_os.default.homedir(), ".codex");
+}
+function installIntoHome(target, home, packageRoot, force = false) {
+  const runtimeDir = import_node_path.default.join(home, "tools", SKILL_NAME);
+  const skillDir = import_node_path.default.join(home, "skills", SKILL_NAME);
+  const binDir = import_node_path.default.join(home, "bin");
   const shimPath = import_node_path.default.join(binDir, CLI_NAME);
-  if (options?.force) {
+  if (force) {
     import_node_fs2.default.rmSync(runtimeDir, { recursive: true, force: true });
     import_node_fs2.default.rmSync(skillDir, { recursive: true, force: true });
     import_node_fs2.default.rmSync(shimPath, { force: true });
@@ -3564,7 +3569,8 @@ function installIntoCodexHome(options) {
   const runtimeScript = import_node_path.default.join(runtimeDir, "dist", "index.js");
   writeShim(shimPath, runtimeScript);
   return {
-    codexHome,
+    target,
+    home,
     binDir,
     runtimeDir,
     skillDir,
@@ -3573,6 +3579,31 @@ function installIntoCodexHome(options) {
     pathHint: (process.env.PATH || "").split(import_node_path.default.delimiter).includes(binDir) ? void 0 : `The shim exists, but ${binDir} is not in PATH. Use "${shimPath}" directly or add ${binDir} to PATH.`
   };
 }
+function installIntoAgentHomes(options) {
+  const packageRoot = resolvePackageRoot(__dirname);
+  const agentsHome = options?.agentsHome || getDefaultAgentsHome();
+  const codexHome = options?.codexHome || getDefaultCodexHome();
+  const target = options?.target || "all";
+  if (!["agents", "codex", "all"].includes(target)) {
+    throw new Error(`Unsupported install target "${target}". Use agents, codex or all.`);
+  }
+  const installs = [];
+  if (target === "agents" || target === "all") {
+    installs.push(installIntoHome("agents", agentsHome, packageRoot, options?.force));
+  }
+  if (target === "codex" || target === "all") {
+    const shouldSkipCodex = installs.some((entry) => entry.home === codexHome);
+    if (!shouldSkipCodex) {
+      installs.push(installIntoHome("codex", codexHome, packageRoot, options?.force));
+    }
+  }
+  return {
+    packageName: PACKAGE_NAME,
+    installerName: INSTALLER_NAME,
+    cliName: CLI_NAME,
+    installs
+  };
+}
 
 // src/lib/errors.ts
 var CliError = class extends Error {
@@ -3653,23 +3684,27 @@ function printJson(value) {
 
 // src/installer.ts
 var program2 = new Command();
-program2.name(INSTALLER_NAME).description("Install the Company Agent Wiki skill and CLI into Codex");
-program2.command("install").option("--codex-home <path>", "Target Codex home directory").option("--force", "Replace an existing install", false).option("--json", "Emit JSON output", false).action((options) => {
-  const result = installIntoCodexHome({
+program2.name(INSTALLER_NAME).description("Install the Company Agent Wiki skill and CLI for shared agent homes and Codex compatibility");
+program2.command("install").option("--agents-home <path>", "Target shared agents home directory").option("--codex-home <path>", "Target Codex home directory").option("--target <target>", "Install target: agents, codex or all", "all").option("--force", "Replace an existing install", false).option("--json", "Emit JSON output", false).action((options) => {
+  const result = installIntoAgentHomes({
+    agentsHome: options.agentsHome,
     codexHome: options.codexHome,
-    force: Boolean(options.force)
+    force: Boolean(options.force),
+    target: options.target
   });
   if (options.json) {
     printJson(envelope("install", result));
     return;
   }
-  process.stdout.write(`Installed into ${result.codexHome}
+  for (const install of result.installs) {
+    process.stdout.write(`Installed ${install.target} target into ${install.home}
 `);
-  process.stdout.write(`CLI shim: ${result.shimPath}
+    process.stdout.write(`CLI shim: ${install.shimPath}
 `);
-  if (result.pathHint) {
-    process.stdout.write(`warning: ${result.pathHint}
+    if (install.pathHint) {
+      process.stdout.write(`warning: ${install.pathHint}
 `);
+    }
   }
 });
 async function main() {

package/knowledge/ARCHITECTURE.md

@@ -2,7 +2,7 @@
 
 ## Scope
 
-Phase 1 delivers a publishable CLI and Codex skill for a private, local company knowledge workspace.
+Phase 1 delivers a publishable CLI and a shared agent skill for a private, local company knowledge workspace.
 
 The implementation is intentionally limited to:
 
@@ -46,7 +46,8 @@ The index and manifest are derived artifacts and should stay ignored in the priv
 8. `search`, `route` and `read` either enforce a fresh index or can explicitly auto-rebuild when `--auto-rebuild` is set.
 9. Runtime commands may detect the current workspace automatically when the shell is already inside a private workspace.
 10. A global per-user workspace registry stores known workspace paths and a default workspace so other agents can resolve the knowledge location automatically on macOS, Windows and Linux.
-11. `serve` exposes the same read-only data through a local web view and now distinguishes `missing`, `stale` and `ok` states with a rebuild action.
+11. The installer now targets a shared `~/.agents` home as the primary skill/runtime location and also installs a Codex compatibility mirror under `~/.codex`.
+12. `serve` exposes the same read-only data through a local web view and now distinguishes `missing`, `stale` and `ok` states with a rebuild action.
 
 ## Onboarding Model
 

package/knowledge/KNOWN_LIMITATIONS.md

@@ -30,3 +30,4 @@
 - The CLI can initialize a private Git remote URL, but it does not validate remote policy or access controls.
 - The package does not enforce OS-level filesystem permissions; the workspace owner must place the private workspace in a properly protected location.
 - The global workspace registry is only a discovery layer, not an access-control boundary. Any agent running as the same local user can read the registered workspace path.
+- The installer now targets a shared `~/.agents` home first and mirrors into `~/.codex` for compatibility, but it does not manage every agent product's own skill-indexing or refresh logic automatically.

package/knowledge/RELEASE_CHECKLIST.md

@@ -66,7 +66,8 @@ Installer aus lokalem Tarball:
 ```bash
 TMP="$(mktemp -d)"
 cd "$TMP"
-npx -y -p /absolute/path/to/codecell-germany-company-agent-wiki-skill-0.1.0.tgz company-agent-wiki-skill install --codex-home "$TMP/codex" --force
+npx -y -p /absolute/path/to/codecell-germany-company-agent-wiki-skill-0.1.0.tgz company-agent-wiki-skill install --agents-home "$TMP/agents" --codex-home "$TMP/codex" --force
+"$TMP/agents/bin/company-agent-wiki-cli" --help
 "$TMP/codex/bin/company-agent-wiki-cli" --help
 ```
 
@@ -114,7 +115,8 @@ TMP="$(mktemp -d)"
 CACHE="$(mktemp -d)"
 cd "$TMP"
 npm_config_cache="$CACHE" npx -y @codecell-germany/company-agent-wiki-skill@0.1.0 company-agent-wiki-cli --help
-npm_config_cache="$CACHE" npx -y @codecell-germany/company-agent-wiki-skill@0.1.0 company-agent-wiki-skill install --codex-home "$TMP/codex" --force
+npm_config_cache="$CACHE" npx -y @codecell-germany/company-agent-wiki-skill@0.1.0 company-agent-wiki-skill install --agents-home "$TMP/agents" --codex-home "$TMP/codex" --force
+"$TMP/agents/bin/company-agent-wiki-cli" --help
 "$TMP/codex/bin/company-agent-wiki-cli" --help
 ```
 
@@ -155,6 +157,8 @@ npx -y skills add codecell-germany/company-agent-wiki-skill -g --skill company-a
 
 - CLI läuft über `company-agent-wiki-cli`
 - Installer läuft über `company-agent-wiki-skill`
+- Shared agent install unter `~/.agents` funktioniert
+- Codex-Kompatibilitätsinstall unter `~/.codex` funktioniert
 - README, Skill, Referenzen und Knowledge sind synchron
 - `npm pack` enthält nur gewollte Dateien
 - lokaler Tarball-Smoketest ist grün

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@codecell-germany/company-agent-wiki-skill",
-  "version": "0.1.1",
-  "description": "Context is king: agent-first local company knowledge workspace with metadata-first retrieval, Markdown as truth, SQLite-indexed front matter, Git-aware verification, and a Codex skill installer.",
+  "version": "0.1.3",
+  "description": "Context is king: agent-first local company knowledge workspace with metadata-first retrieval, Markdown as truth, SQLite-indexed front matter, Git-aware verification, and a shared agent skill installer.",
   "private": false,
   "license": "MIT",
   "type": "commonjs",

package/skills/company-agent-wiki-cli/SKILL.md

@@ -12,6 +12,8 @@ Use this skill when the task is about a private company knowledge workspace buil
 - Git-backed history
 - a read-only local browsing view
 
+This package now targets a shared `~/.agents` home first so the same published package can work across multiple agent runtimes, not only Codex.
+
 ## Preconditions
 
 - The public CLI binary is `company-agent-wiki-cli`.
@@ -19,21 +21,37 @@ Use this skill when the task is about a private company knowledge workspace buil
 - The private workspace may be the current dedicated local folder; it just must not be the public skill/CLI repo.
 - The human should provide the workspace path at least once and, if desired, the private Git remote URL. After setup or manual registration, the CLI stores the workspace path in a global per-user registry so later agents can resolve it automatically.
 - Runtime discovery matters. Before relying on the CLI, verify which path is actually available.
-- In Codex, the most reliable fallback is usually the installed shim under `$CODEX_HOME/bin` or `~/.codex/bin`.
-- The `npx -p @codecell-germany/company-agent-wiki-skill ...` path only works after the npm package is really published.
-- `node dist/index.js` only works inside the public implementation repo after `npm run build`, not inside an arbitrary private workspace.
+- The primary shared install target is `~/.agents`. Codex additionally gets a compatibility mirror under `~/.codex`.
+- The preferred one-command installer path is `npx -y -p @codecell-germany/company-agent-wiki-skill company-agent-wiki-skill install --force`. This only works after the npm package is really published.
 - If the binary is not already installed in PATH, use these fallbacks in this order:
 
 ```bash
+"$HOME/.agents/bin/company-agent-wiki-cli" --help
+"$AGENTS_HOME/bin/company-agent-wiki-cli" --help
 "$CODEX_HOME/bin/company-agent-wiki-cli" --help
 "$HOME/.codex/bin/company-agent-wiki-cli" --help
-npx -p @codecell-germany/company-agent-wiki-skill company-agent-wiki-cli --help
+company-agent-wiki-cli --help
+npx -y -p @codecell-germany/company-agent-wiki-skill company-agent-wiki-skill install --force
+```
+
+If you are actively developing inside the public implementation repo, the repo-local fallback also exists:
+
+```bash
+"$HOME/.agents/bin/company-agent-wiki-cli" --help
+"$CODEX_HOME/bin/company-agent-wiki-cli" --help
 node dist/index.js --help
 ```
 
 ## First Run
 
-1. In Codex, start with the explicit shim paths:
+1. Start with the shared agent shim path:
+
+```bash
+"$HOME/.agents/bin/company-agent-wiki-cli" --help
+"$AGENTS_HOME/bin/company-agent-wiki-cli" --help
+```
+
+If you are in Codex, the compatibility shim also works:
 
 ```bash
 "$CODEX_HOME/bin/company-agent-wiki-cli" --help
@@ -46,10 +64,10 @@ If that fails, try the PATH binary as a convenience fallback:
 company-agent-wiki-cli --help
 ```
 
-Only if the package is already published should you rely on:
+If the CLI is not installed yet and the package is already published, install it with one command:
 
 ```bash
-npx -p @codecell-germany/company-agent-wiki-skill company-agent-wiki-cli --help
+npx -y -p @codecell-germany/company-agent-wiki-skill company-agent-wiki-skill install --force
 ```
 
 2. If no private workspace exists yet, create one:

package/skills/company-agent-wiki-cli/references/agent-onboarding.md

@@ -3,6 +3,9 @@
 ## Use This Sequence
 
 ```bash
+npx -y -p @codecell-germany/company-agent-wiki-skill company-agent-wiki-skill install --force
+"$HOME/.agents/bin/company-agent-wiki-cli" --help
+"$AGENTS_HOME/bin/company-agent-wiki-cli" --help
 "$CODEX_HOME/bin/company-agent-wiki-cli" --help
 "$HOME/.codex/bin/company-agent-wiki-cli" --help
 company-agent-wiki-cli --help

package/skills/company-agent-wiki-cli/references/command-cheatsheet.md

@@ -3,6 +3,9 @@
 ## Workspace
 
 ```bash
+npx -y -p @codecell-germany/company-agent-wiki-skill company-agent-wiki-skill install --force
+"$HOME/.agents/bin/company-agent-wiki-cli" --help
+"$AGENTS_HOME/bin/company-agent-wiki-cli" --help
 "$CODEX_HOME/bin/company-agent-wiki-cli" --help
 "$HOME/.codex/bin/company-agent-wiki-cli" --help
 company-agent-wiki-cli about --json

package/skills/company-agent-wiki-cli/references/company-onboarding.md

@@ -59,7 +59,7 @@ If target files already exist, the CLI refuses the write unless `--force` is add
 
 ```json
 {
-  "answeredBy": "Codex Agent",
+  "answeredBy": "AI Agent",
   "notes": ["Buchhaltung zuerst priorisieren"],
   "answers": {
     "official_legal_name": "Beispiel GmbH",

package/skills/company-agent-wiki-cli/references/overview.md

@@ -1,6 +1,7 @@
 # Overview
 
 `company-agent-wiki-cli` is the public interface for a private, local company knowledge workspace.
+The published package now installs into a shared `~/.agents` home first and mirrors into `~/.codex` for Codex compatibility.
 
 ## Source of Truth
 

package/skills/company-agent-wiki-cli/references/workspace-first-run.md

@@ -25,12 +25,15 @@ The workspace path only has to be provided once. After setup or manual registrat
 Before relying on the CLI, verify a real executable path:
 
 ```bash
+npx -y -p @codecell-germany/company-agent-wiki-skill company-agent-wiki-skill install --force
+"$HOME/.agents/bin/company-agent-wiki-cli" --help
+"$AGENTS_HOME/bin/company-agent-wiki-cli" --help
 "$CODEX_HOME/bin/company-agent-wiki-cli" --help
 "$HOME/.codex/bin/company-agent-wiki-cli" --help
 company-agent-wiki-cli --help
 ```
 
-The package-based `npx` path is only valid once the npm package is published.
+The package-based `npx` installer path is only valid once the npm package is published.
 
 If the current folder is already inside a private workspace, runtime commands may omit `--workspace`.
 If not, inspect or update the global registry: