vaultctl 0.3.2 → 0.4.0

package/README.md

@@ -14,13 +14,10 @@ MCP servers for Obsidian + Claude Code CLI are [fundamentally broken](https://gi
 
 ```bash
 npm install -g vaultctl
+vaultctl config set vault ~/path/to/your/vault
 ```
 
-Then set your vault path in `~/.zshrc` or `~/.bashrc`:
-
-```bash
-export VAULTCTL_PATH="$HOME/path/to/your/vault"
-```
+That's it. The config is saved to `~/.vaultctlrc` and works everywhere — interactive shells, AI agents, cron jobs, CI.
 
 ### From Source
 
@@ -29,13 +26,8 @@ git clone https://github.com/testing-in-production/vaultctl.git
 cd vaultctl
 npm install
 npm run build
-```
-
-Then add to your shell profile:
-
-```bash
-export VAULTCTL_PATH="$HOME/path/to/your/vault"
 alias vaultctl="node $HOME/vaultctl/packages/cli/dist/index.js"
+vaultctl config set vault ~/path/to/your/vault
 ```
 
 ## Usage
@@ -126,6 +118,12 @@ Exit codes: `0` = success, `1` = error, `2` = no results found.
 3. Walk up from current directory looking for `.obsidian/`
 4. `~/.vaultctlrc` config file
 
+### Why `config set` Instead of Environment Variables?
+
+Shell aliases and environment variables from `~/.zshrc` or `~/.bashrc` aren't available in non-interactive shells (AI agents, cron jobs, CI). `vaultctl config set vault` writes to `~/.vaultctlrc`, which is a file read — it works everywhere.
+
+You can still use `VAULTCTL_PATH` or `--vault` if you prefer — they take higher precedence in the discovery chain.
+
 ## Features
 
 - **Search** — Full-text content search with type, status, and tag filters

package/dist/commands/config.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerConfigCommand(program: Command): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.js

@@ -0,0 +1,79 @@
+import { resolve, join } from 'path';
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
+import { formatOutput } from '../format.js';
+const RC_PATH = join(homedir(), '.vaultctlrc');
+export function registerConfigCommand(program) {
+    const config = program
+        .command('config')
+        .description('Manage vaultctl configuration');
+    config
+        .command('show')
+        .description('Show current configuration and vault discovery status')
+        .action((_opts, cmd) => {
+        const globalOpts = cmd.parent.parent.opts();
+        const format = (globalOpts.format ?? 'json');
+        const rcExists = existsSync(RC_PATH);
+        const rcValue = rcExists ? readFileSync(RC_PATH, 'utf-8').trim() : null;
+        const envValue = process.env['VAULTCTL_PATH'] ?? null;
+        // Determine which method would resolve
+        let resolvedBy = 'none';
+        let resolvedPath = null;
+        if (globalOpts.vault) {
+            const abs = resolve(globalOpts.vault);
+            if (existsSync(join(abs, '.obsidian'))) {
+                resolvedBy = '--vault flag';
+                resolvedPath = abs;
+            }
+        }
+        if (!resolvedPath && envValue) {
+            const abs = resolve(envValue);
+            if (existsSync(join(abs, '.obsidian'))) {
+                resolvedBy = 'VAULTCTL_PATH env var';
+                resolvedPath = abs;
+            }
+        }
+        if (!resolvedPath && rcValue) {
+            const abs = resolve(rcValue);
+            if (existsSync(join(abs, '.obsidian'))) {
+                resolvedBy = '~/.vaultctlrc';
+                resolvedPath = abs;
+            }
+        }
+        const result = {
+            rc_file: RC_PATH,
+            rc_value: rcValue,
+            env_var: envValue,
+            resolved_by: resolvedBy,
+            resolved_path: resolvedPath,
+        };
+        console.log(formatOutput(result, format));
+    });
+    config
+        .command('set')
+        .description('Set a configuration value')
+        .argument('<key>', 'Configuration key (currently: vault)')
+        .argument('<value>', 'Configuration value')
+        .action((key, value, _opts, cmd) => {
+        const globalOpts = cmd.parent.parent.opts();
+        const format = (globalOpts.format ?? 'json');
+        if (key !== 'vault') {
+            console.error(`Unknown config key: "${key}". Available keys: vault`);
+            process.exit(1);
+        }
+        const abs = resolve(value);
+        if (!existsSync(join(abs, '.obsidian'))) {
+            console.error(`No .obsidian directory found at: ${abs}`);
+            process.exit(1);
+        }
+        writeFileSync(RC_PATH, abs + '\n', 'utf-8');
+        const result = {
+            saved: true,
+            key: 'vault',
+            value: abs,
+            rc_file: RC_PATH,
+        };
+        console.log(formatOutput(result, format));
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/index.js

@@ -6,11 +6,12 @@ import { registerHealthCommand } from './commands/health.js';
 import { registerCreateCommand } from './commands/create.js';
 import { registerReadCommand } from './commands/read.js';
 import { registerInfoCommand } from './commands/info.js';
+import { registerConfigCommand } from './commands/config.js';
 const program = new Command();
 program
     .name('vaultctl')
     .description('Structured Obsidian vault operations without MCP servers')
-    .version('0.3.2')
+    .version('0.4.0')
     .option('--vault <path>', 'Path to Obsidian vault')
     .option('--format <format>', 'Output format: json or table', 'json');
 registerSearchCommand(program);
@@ -19,5 +20,6 @@ registerHealthCommand(program);
 registerCreateCommand(program);
 registerReadCommand(program);
 registerInfoCommand(program);
+registerConfigCommand(program);
 program.parse();
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vaultctl",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "CLI for structured Obsidian vault operations — search, tags, health checks, templates — without MCP servers",
   "type": "module",
   "license": "MIT",
@@ -25,7 +25,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@vaultctl/core": "^0.3.2",
+    "@vaultctl/core": "^0.4.0",
     "chalk": "^5.4.0",
     "commander": "^13.0.0"
   }