@alessandroraffa/tangyr 0.10.1 → 0.11.0

package/README.md

@@ -107,13 +107,24 @@ claudeCodeGlobalPaths:
   - ~/.claude-work
 ```
 
-**Via CLI flag** (repeatable, overrides the config field):
+**Via environment variable** (`TANGYR_CLAUDE_CONFIG_DIRS`):
+
+A colon-separated list of Claude Code global root directories. Entries support `~/` expansion. This layer is designed for machine-specific configuration that must not be committed to a shared kit config.
+
+```sh
+export TANGYR_CLAUDE_CONFIG_DIRS="~/.claude:~/.claude-work"
+tangyr sync
+```
+
+Auto-sync use case: if a kit-change hook or automation runs `tangyr sync`, exporting `TANGYR_CLAUDE_CONFIG_DIRS` in the shell environment keeps multiple Claude configs in sync automatically — without putting machine-specific paths in a shared `tangyr.config.yaml`.
+
+**Via CLI flag** (repeatable):
 
 ```sh
 tangyr sync --claude-config-dir ~/.claude --claude-config-dir ~/.claude-work
 ```
 
-Precedence: `--claude-config-dir` flag > `claudeCodeGlobalPaths` in config > default `~/.claude`.
+Precedence: `--claude-config-dir` flag > `TANGYR_CLAUDE_CONFIG_DIRS` env > `claudeCodeGlobalPaths` in config > default `~/.claude`.
 
 Per-root artifacts (instructions, agents, skills, commands, rules, output-styles, hooks settings) are written under each root. Shared artifacts (`~/.claude.json` for MCP, `~/.agents/hooks` for hooks) are resolved from the platform default and written once regardless of how many roots are configured.
 

package/dist/index.js

@@ -15644,8 +15644,12 @@ function resolveClineProfile(scope, projectRoot, mappings) {
   };
 }
 var DEFAULT_CLAUDE_ROOT_RAW = "~/.claude";
+function parseEnvDirs(raw) {
+  return raw.split(":").map((s) => s.trim()).filter((s) => s.length > 0);
+}
 function resolveClaudeGlobalRoots(input) {
-  const rawRoots = (input.flag?.length ?? 0) > 0 ? input.flag : (input.config?.length ?? 0) > 0 ? input.config : [DEFAULT_CLAUDE_ROOT_RAW];
+  const envEntries = input.env !== void 0 ? parseEnvDirs(input.env) : void 0;
+  const rawRoots = (input.flag?.length ?? 0) > 0 ? input.flag : envEntries !== void 0 && envEntries.length > 0 ? envEntries : (input.config?.length ?? 0) > 0 ? input.config : [DEFAULT_CLAUDE_ROOT_RAW];
   const seen = /* @__PURE__ */ new Set();
   const roots = [];
   for (const raw of rawRoots) {
@@ -26497,6 +26501,7 @@ function installForTool(tool, config, kitInfo, manifest, options, mappings, logg
   );
   const claudeRoots = scope === "global" && mappings ? resolveClaudeGlobalRoots({
     flag: options.claudeConfigDir,
+    env: process.env.TANGYR_CLAUDE_CONFIG_DIRS,
     config: config.claudeCodeGlobalPaths
   }) : void 0;
   let count = 0;
@@ -28869,6 +28874,7 @@ function runSyncCommand(options, logger) {
   const allMappings = mappings ?? (targets.includes("claude-code") ? loadMappings(sourceRoot, config, configDir) : void 0);
   const claudeRoots = targets.includes("claude-code") && syncOptions.scope === "global" && allMappings ? resolveClaudeGlobalRoots({
     flag: options.claudeConfigDir,
+    env: process.env.TANGYR_CLAUDE_CONFIG_DIRS,
     config: config.claudeCodeGlobalPaths
   }) : void 0;
   for (const target of targets) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alessandroraffa/tangyr",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "description": "CLI for the Tangyr discipline — install and manage operating kits for AI coding tools",
   "license": "MIT",
   "type": "module",