klaudiak 2.1.88 → 2.1.89

package/Makefile

@@ -160,4 +160,25 @@ publish:
 	trap 'rm -f "$$tmp_npmrc"' EXIT; \
 	printf '//registry.npmjs.org/:_authToken=%s\n' "$$token" > "$$tmp_npmrc"; \
 	printf 'always-auth=true\n' >> "$$tmp_npmrc"; \
-	AUTHORIZED=1 NPM_CONFIG_USERCONFIG="$$tmp_npmrc" npm publish --access public
+	AUTHORIZED=1 NPM_CONFIG_USERCONFIG="$$tmp_npmrc" npm publish --access public
+
+
+.PHONY: publish-update
+publish-update:
+	@set -euo pipefail; \
+	npm version patch --no-git-tag-version; \
+	$(MAKE) publish
+
+
+.PHONY: publish-update-minor
+publish-update-minor:
+	@set -euo pipefail; \
+	npm version minor --no-git-tag-version; \
+	$(MAKE) publish
+
+
+.PHONY: publish-update-major
+publish-update-major:
+	@set -euo pipefail; \
+	npm version major --no-git-tag-version; \
+	$(MAKE) publish

package/README.md

@@ -28,12 +28,16 @@ npx klaudiak
 
 ```bash
 klaudiak
+klaudiak --profile=<name>
 klaudiak --port=<port>
 ```
 
 - `klaudiak` starts the coding agent.
+- `--profile=<name>` loads settings from `~/.klaudiak` profile `<name>`.
 - `--port=<port>` sets `ANTHROPIC_BASE_URL=http://localhost:<port>` for this run when not already set.
 
+When no profile flag is passed, Klaudiak always uses the `default` profile.
+
 ### Start proxy
 
 ```bash
@@ -50,6 +54,37 @@ klaudiak proxy openai/gpt-4o-mini key sk-or-v1-... --port=9090
 - `<apiKey>` is passed to `OPENROUTER_API_KEY`.
 - `--port=<port>` is passed to `PROXY_PORT`.
 
+You can also run proxy from a profile (no model/key arguments) when profile `type` is `proxy` and includes `openrouterModel` + `openrouterApiKey`:
+
+```bash
+klaudiak proxy --profile=<name>
+```
+
+### Global defaults profiles
+
+Klaudiak stores global profile defaults in `~/.klaudiak` (JSON). The file is auto-created whenever `klaudiak` runs.
+
+Common commands:
+
+```bash
+klaudiak defaults list
+klaudiak defaults create gemini
+klaudiak defaults set gemini type proxy
+klaudiak defaults set gemini openrouterModel google/gemini-2.5-pro
+klaudiak defaults set gemini openrouterApiKey sk-or-v1-...
+klaudiak defaults show gemini
+```
+
+Supported fields:
+
+- `type` (`agent` or `proxy`)
+- `anthropicBaseUrl`
+- `anthropicApiKey`
+- `anthropicModel`
+- `proxyPort`
+- `openrouterModel`
+- `openrouterApiKey`
+
 ## How It Works
 
 ```text

package/klaudiak-help.md

@@ -0,0 +1,14 @@
+Klaudia Kode CLI
+
+install using 
+$ npm install -g klaudiak
+
+Usage:
+  klaudiak
+  klaudiak --port=<port>
+  klaudiak proxy <model> key <apiKey> --port=<port>
+
+Examples:
+  klaudiak
+  klaudiak --port=10000
+  klaudiak proxy deepseek/deepseek-chat-v3-0324 key sk-or-v1-... --port=10000

package/klaudiak.js

@@ -1,43 +1,215 @@
 #!/usr/bin/env node
 
 import { spawn } from 'child_process';
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
+const DEFAULTS_PATH = join(homedir(), '.klaudiak');
+const DEFAULT_PROFILE_NAME = 'default';
+const PROFILE_NAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/;
+const PROFILE_FIELDS = new Set([
+  'type',
+  'anthropicBaseUrl',
+  'anthropicApiKey',
+  'anthropicModel',
+  'proxyPort',
+  'openrouterModel',
+  'openrouterApiKey',
+]);
 
 const args = process.argv.slice(2);
 
+function defaultProfile() {
+  return {
+    type: 'agent',
+    anthropicBaseUrl: 'http://localhost:9090',
+    anthropicApiKey: '',
+    anthropicModel: '',
+    proxyPort: 9090,
+    openrouterModel: '',
+    openrouterApiKey: '',
+  };
+}
+
+function defaultDefaultsConfig() {
+  return {
+    version: 1,
+    profiles: {
+      [DEFAULT_PROFILE_NAME]: defaultProfile(),
+    },
+  };
+}
+
+function redactedProfile(profile) {
+  return {
+    ...profile,
+    anthropicApiKey: profile.anthropicApiKey ? '***' : '',
+    openrouterApiKey: profile.openrouterApiKey ? '***' : '',
+  };
+}
+
+function parsePortValue(raw, flagName = '--port') {
+  const port = Number(raw);
+  if (!Number.isInteger(port) || port < 1 || port > 65535) {
+    console.error(`Error: invalid ${flagName} value "${raw}". Expected integer in range 1-65535.`);
+    process.exit(1);
+  }
+  return port;
+}
+
+function parseTypedValue(field, value) {
+  if (field === 'proxyPort') {
+    return parsePortValue(value, 'proxyPort');
+  }
+  if (field === 'type') {
+    const normalized = String(value).toLowerCase();
+    if (normalized !== 'agent' && normalized !== 'proxy') {
+      console.error('Error: field "type" must be one of: agent, proxy');
+      process.exit(1);
+    }
+    return normalized;
+  }
+  return String(value);
+}
+
+function sanitizeProfile(raw) {
+  const profile = defaultProfile();
+  if (!raw || typeof raw !== 'object') return profile;
+
+  for (const field of PROFILE_FIELDS) {
+    if (raw[field] === undefined || raw[field] === null) continue;
+    if (field === 'proxyPort') {
+      profile.proxyPort = parsePortValue(String(raw.proxyPort), 'proxyPort');
+      continue;
+    }
+    if (field === 'type') {
+      profile.type = parseTypedValue('type', raw.type);
+      continue;
+    }
+    profile[field] = String(raw[field]);
+  }
+
+  return profile;
+}
+
+function ensureDefaultsFile() {
+  if (!existsSync(DEFAULTS_PATH)) {
+    writeFileSync(DEFAULTS_PATH, `${JSON.stringify(defaultDefaultsConfig(), null, 2)}\n`, 'utf8');
+  }
+}
+
+function loadDefaultsConfig() {
+  ensureDefaultsFile();
+  try {
+    const raw = JSON.parse(readFileSync(DEFAULTS_PATH, 'utf8'));
+    if (!raw || typeof raw !== 'object') throw new Error('invalid root object');
+
+    const profiles = raw.profiles && typeof raw.profiles === 'object' ? raw.profiles : {};
+    const normalizedProfiles = {};
+    for (const [name, profile] of Object.entries(profiles)) {
+      if (!PROFILE_NAME_RE.test(name)) continue;
+      normalizedProfiles[name] = sanitizeProfile(profile);
+    }
+
+    if (!normalizedProfiles[DEFAULT_PROFILE_NAME]) {
+      normalizedProfiles[DEFAULT_PROFILE_NAME] = defaultProfile();
+    }
+
+    return {
+      version: 1,
+      profiles: normalizedProfiles,
+    };
+  } catch (err) {
+    console.error(`Warning: invalid ~/.klaudiak JSON (${err.message}). Recreating with defaults.`);
+    const fallback = defaultDefaultsConfig();
+    saveDefaultsConfig(fallback);
+    return fallback;
+  }
+}
+
+function saveDefaultsConfig(config) {
+  writeFileSync(DEFAULTS_PATH, `${JSON.stringify(config, null, 2)}\n`, 'utf8');
+}
+
+function resolveProfileNameAndArgs(argv) {
+  let profileName = DEFAULT_PROFILE_NAME;
+  const filtered = [];
+
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === '--profile' || arg === '--defaults') {
+      const value = argv[i + 1];
+      if (!value) {
+        console.error(`Error: ${arg} requires a value.`);
+        process.exit(1);
+      }
+      profileName = value.trim();
+      i++;
+      continue;
+    }
+    if (arg.startsWith('--profile=')) {
+      profileName = arg.slice('--profile='.length).trim();
+      continue;
+    }
+    if (arg.startsWith('--defaults=')) {
+      profileName = arg.slice('--defaults='.length).trim();
+      continue;
+    }
+    filtered.push(arg);
+  }
+
+  if (!PROFILE_NAME_RE.test(profileName)) {
+    console.error(`Error: invalid profile name "${profileName}".`);
+    process.exit(1);
+  }
+
+  return { profileName, args: filtered };
+}
+
 function printUsage() {
   console.log([
     'Klaudia Kode CLI',
     '',
     'Usage:',
     '  klaudiak',
+    '  klaudiak --profile=<name>',
     '  klaudiak --port=<port>',
+    '  klaudiak defaults <list|show|create|delete|set|unset>',
     '  klaudiak proxy <model> key <apiKey> --port=<port>',
     '',
     'Examples:',
     '  klaudiak',
+    '  klaudiak --profile=gemini',
     '  klaudiak --port=10000',
+    '  klaudiak defaults create gemini',
+    '  klaudiak defaults set gemini type proxy',
+    '  klaudiak defaults set gemini openrouterModel google/gemini-2.5-pro',
+    '  klaudiak defaults set gemini openrouterApiKey sk-or-v1-...',
     '  klaudiak proxy deepseek/deepseek-chat-v3-0324 key sk-or-v1-... --port=10000',
   ].join('\n'));
 }
 
 function parsePort(argv) {
-  const portArg = argv.find(a => a.startsWith('--port='));
-  if (!portArg) return null;
-
-  const raw = portArg.slice('--port='.length).trim();
-  const port = Number(raw);
-
-  if (!Number.isInteger(port) || port < 1 || port > 65535) {
-    console.error(`Error: invalid --port value "${raw}". Expected integer in range 1-65535.`);
-    process.exit(1);
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === '--port') {
+      const raw = argv[i + 1];
+      if (!raw) {
+        console.error('Error: --port requires a value.');
+        process.exit(1);
+      }
+      return parsePortValue(String(raw).trim(), '--port');
+    }
+    if (arg.startsWith('--port=')) {
+      const raw = arg.slice('--port='.length).trim();
+      return parsePortValue(raw, '--port');
+    }
   }
-
-  return port;
+  return null;
 }
 
 function spawnNode(scriptPath, scriptArgs, env) {
@@ -56,28 +228,80 @@ function spawnNode(scriptPath, scriptArgs, env) {
 }
 
 function runAgent(argv) {
+  const { profileName, args: filteredArgs } = resolveProfileNameAndArgs(argv);
+  const defaults = loadDefaultsConfig();
+  const profile = defaults.profiles[profileName];
+  if (!profile) {
+    console.error(`Error: profile "${profileName}" was not found in ~/.klaudiak`);
+    process.exit(1);
+  }
+
   const port = parsePort(argv);
-  const forwardArgs = argv.filter(a => !a.startsWith('--port='));
+  const forwardArgs = [];
+  for (let i = 0; i < filteredArgs.length; i++) {
+    const arg = filteredArgs[i];
+    if (arg === '--port') {
+      i++;
+      continue;
+    }
+    if (arg.startsWith('--port=')) {
+      continue;
+    }
+    forwardArgs.push(arg);
+  }
   const env = { ...process.env };
 
+  if (profile.anthropicApiKey && !env.ANTHROPIC_API_KEY) {
+    env.ANTHROPIC_API_KEY = profile.anthropicApiKey;
+  }
+  if (profile.anthropicModel && !env.ANTHROPIC_MODEL) {
+    env.ANTHROPIC_MODEL = profile.anthropicModel;
+  }
+
+  if (profile.anthropicBaseUrl && !env.ANTHROPIC_BASE_URL) {
+    env.ANTHROPIC_BASE_URL = profile.anthropicBaseUrl;
+  }
+
   if (port !== null) {
     env.ANTHROPIC_BASE_URL = `http://localhost:${port}`;
   } else if (!env.ANTHROPIC_BASE_URL) {
-    env.ANTHROPIC_BASE_URL = 'http://localhost:9090';
+    env.ANTHROPIC_BASE_URL = profile.anthropicBaseUrl || 'http://localhost:9090';
   }
 
   spawnNode(join(__dirname, 'cli.js'), forwardArgs, env);
 }
 
 function runProxy(argv) {
-  if (argv.length < 4 || argv[1] !== 'key') {
+  const { profileName, args: filteredArgs } = resolveProfileNameAndArgs(argv);
+  const defaults = loadDefaultsConfig();
+  const profile = defaults.profiles[profileName];
+  if (!profile) {
+    console.error(`Error: profile "${profileName}" was not found in ~/.klaudiak`);
+    process.exit(1);
+  }
+
+  const effectiveArgs = filteredArgs;
+  if (effectiveArgs.length < 3 || effectiveArgs[1] !== 'key') {
+    if (effectiveArgs.length === 0 && profile.type === 'proxy' && profile.openrouterModel && profile.openrouterApiKey) {
+      const env = {
+        ...process.env,
+        OPENROUTER_MODEL: profile.openrouterModel,
+        OPENROUTER_API_KEY: profile.openrouterApiKey,
+      };
+      if (profile.proxyPort) {
+        env.PROXY_PORT = String(profile.proxyPort);
+      }
+      spawnNode(join(__dirname, 'openrouter-proxy.mjs'), [], env);
+      return;
+    }
+
     console.error('Error: invalid proxy command syntax.');
     printUsage();
     process.exit(1);
   }
 
-  const model = argv[0]?.trim();
-  const apiKey = argv[2]?.trim();
+  const model = effectiveArgs[0]?.trim();
+  const apiKey = effectiveArgs[2]?.trim();
 
   if (!model) {
     console.error('Error: missing model.');
@@ -89,14 +313,30 @@ function runProxy(argv) {
     process.exit(1);
   }
 
-  const tail = argv.slice(3);
-  if (tail.some(a => !a.startsWith('--port='))) {
-    console.error('Error: unexpected arguments. Only --port=<port> is supported after API key.');
+  const tail = effectiveArgs.slice(3);
+  const validTail = [];
+  for (let i = 0; i < tail.length; i++) {
+    const arg = tail[i];
+    if (arg === '--port') {
+      const value = tail[i + 1];
+      if (!value) {
+        console.error('Error: --port requires a value.');
+        process.exit(1);
+      }
+      validTail.push(arg, value);
+      i++;
+      continue;
+    }
+    if (arg.startsWith('--port=')) {
+      validTail.push(arg);
+      continue;
+    }
+    console.error('Error: unexpected arguments. Only --port=<port> or --port <port> is supported after API key.');
     printUsage();
     process.exit(1);
   }
 
-  const port = parsePort(tail);
+  const port = parsePort(validTail);
   const env = {
     ...process.env,
     OPENROUTER_MODEL: model,
@@ -110,12 +350,145 @@ function runProxy(argv) {
   spawnNode(join(__dirname, 'openrouter-proxy.mjs'), [], env);
 }
 
+function runDefaults(argv) {
+  const defaults = loadDefaultsConfig();
+  const [subcommand, ...rest] = argv;
+
+  if (!subcommand || subcommand === 'help' || subcommand === '--help' || subcommand === '-h') {
+    console.log([
+      'Manage ~/.klaudiak profiles',
+      '',
+      'Usage:',
+      '  klaudiak defaults list',
+      '  klaudiak defaults show <name>',
+      '  klaudiak defaults create <name>',
+      '  klaudiak defaults delete <name>',
+      '  klaudiak defaults set <name> <field> <value>',
+      '  klaudiak defaults unset <name> <field>',
+      '',
+      `Fields: ${Array.from(PROFILE_FIELDS).join(', ')}`,
+    ].join('\n'));
+    return;
+  }
+
+  if (subcommand === 'list') {
+    const names = Object.keys(defaults.profiles).sort();
+    for (const name of names) {
+      const type = defaults.profiles[name].type || 'agent';
+      console.log(`${name} (${type})`);
+    }
+    return;
+  }
+
+  if (subcommand === 'show') {
+    const name = rest[0];
+    if (!name) {
+      console.error('Error: missing profile name.');
+      process.exit(1);
+    }
+    const profile = defaults.profiles[name];
+    if (!profile) {
+      console.error(`Error: profile "${name}" was not found.`);
+      process.exit(1);
+    }
+    console.log(JSON.stringify(redactedProfile(profile), null, 2));
+    return;
+  }
+
+  if (subcommand === 'create') {
+    const name = rest[0];
+    if (!name) {
+      console.error('Error: missing profile name.');
+      process.exit(1);
+    }
+    if (!PROFILE_NAME_RE.test(name)) {
+      console.error(`Error: invalid profile name "${name}".`);
+      process.exit(1);
+    }
+    if (defaults.profiles[name]) {
+      console.error(`Error: profile "${name}" already exists.`);
+      process.exit(1);
+    }
+    defaults.profiles[name] = defaultProfile();
+    saveDefaultsConfig(defaults);
+    console.log(`Created profile "${name}".`);
+    return;
+  }
+
+  if (subcommand === 'delete') {
+    const name = rest[0];
+    if (!name) {
+      console.error('Error: missing profile name.');
+      process.exit(1);
+    }
+    if (name === DEFAULT_PROFILE_NAME) {
+      console.error('Error: cannot delete the default profile.');
+      process.exit(1);
+    }
+    if (!defaults.profiles[name]) {
+      console.error(`Error: profile "${name}" was not found.`);
+      process.exit(1);
+    }
+    delete defaults.profiles[name];
+    saveDefaultsConfig(defaults);
+    console.log(`Deleted profile "${name}".`);
+    return;
+  }
+
+  if (subcommand === 'set') {
+    const [name, field, ...valueParts] = rest;
+    if (!name || !field || valueParts.length === 0) {
+      console.error('Error: usage: klaudiak defaults set <name> <field> <value>');
+      process.exit(1);
+    }
+    if (!defaults.profiles[name]) {
+      console.error(`Error: profile "${name}" was not found.`);
+      process.exit(1);
+    }
+    if (!PROFILE_FIELDS.has(field)) {
+      console.error(`Error: unknown field "${field}".`);
+      process.exit(1);
+    }
+    defaults.profiles[name][field] = parseTypedValue(field, valueParts.join(' '));
+    saveDefaultsConfig(defaults);
+    console.log(`Set ${name}.${field}`);
+    return;
+  }
+
+  if (subcommand === 'unset') {
+    const [name, field] = rest;
+    if (!name || !field) {
+      console.error('Error: usage: klaudiak defaults unset <name> <field>');
+      process.exit(1);
+    }
+    if (!defaults.profiles[name]) {
+      console.error(`Error: profile "${name}" was not found.`);
+      process.exit(1);
+    }
+    if (!PROFILE_FIELDS.has(field)) {
+      console.error(`Error: unknown field "${field}".`);
+      process.exit(1);
+    }
+    defaults.profiles[name][field] = defaultProfile()[field];
+    saveDefaultsConfig(defaults);
+    console.log(`Unset ${name}.${field}`);
+    return;
+  }
+
+  console.error(`Error: unknown defaults subcommand "${subcommand}".`);
+  process.exit(1);
+}
+
+ensureDefaultsFile();
+
 if (args.includes('--help') || args.includes('-h')) {
   printUsage();
   process.exit(0);
 }
 
-if (args.length > 0 && args[0] === 'proxy') {
+if (args.length > 0 && args[0] === 'defaults') {
+  runDefaults(args.slice(1));
+} else if (args.length > 0 && args[0] === 'proxy') {
   runProxy(args.slice(1));
 } else {
   runAgent(args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "klaudiak",
-  "version": "2.1.88",
+  "version": "2.1.89",
   "bin": {
     "klaudiak": "klaudiak.js"
   },

package/user-manual.md

@@ -1,331 +0,0 @@
-# claude-code-anymodel User Manual
-
-This manual is for users who want to run this AI coding agent at full power.
-
-## 1) What This Project Is
-
-This project is an AnyModel-flavored Claude Code client:
-
-- Interactive coding agent in your terminal
-- Works with Anthropic-compatible endpoints
-- Can route through AnyModel proxy to OpenRouter or Ollama
-- Supports one-shot automation and long interactive sessions
-
-Primary references in this repo:
-
-- Runtime options and subcommands: [main.tsx](main.tsx)
-- Slash-command registry: [commands.ts](commands.ts)
-- Quickstart and proxy framing: [README.md](README.md)
-- Workflow recipes: [Makefile](Makefile)
-
-## 2) Prerequisites
-
-- Node.js 18+ (required by [package.json](package.json))
-- A shell environment where `npx` is available
-- Optional for proxy workflows:
-  - OpenRouter API key (`OPENROUTER_API_KEY`)
-  - Ollama installed and running locally
-
-Quick check:
-
-```bash
-make env-init
-make check-node
-make help-cli
-```
-
-### Optional but recommended: use a local `.env`
-
-This repo now supports a no-friction env workflow:
-
-- `make env-init` creates `.env` from [\.env.example](.env.example)
-- [Makefile](Makefile) auto-loads `.env` for all targets
-- [openrouter-proxy.mjs](openrouter-proxy.mjs) also reads `.env` directly
-
-That means you can set keys once in `.env` and stop re-exporting each session.
-
-## 3) Fastest Start
-
-### Anthropic/compatible direct flow
-
-```bash
-make run
-```
-
-### OpenRouter flow (2 terminals)
-
-Terminal A:
-
-```bash
-export OPENROUTER_API_KEY=sk-or-v1-...
-make proxy-openrouter
-```
-
-Terminal B:
-
-```bash
-make run-openrouter
-```
-
-### Ollama flow (3 terminals)
-
-Terminal A:
-
-```bash
-ollama serve
-```
-
-Terminal B:
-
-```bash
-make proxy-ollama OLLAMA_MODEL=llama3.1
-```
-
-Terminal C:
-
-```bash
-make run-ollama OLLAMA_MODEL=llama3.1
-```
-
-## 4) Core Run Modes You Should Master
-
-### Interactive mode (default)
-
-Best for complex coding tasks, repo exploration, refactoring loops.
-
-```bash
-make run
-```
-
-### Bare mode
-
-Use this for minimal runtime overhead and fewer moving pieces.
-
-```bash
-make bare
-```
-
-### One-shot print mode
-
-Great for scripts, CI-style invocation, and deterministic automation.
-
-```bash
-make print PROMPT='summarize this repository architecture'
-make print-json PROMPT='return a JSON checklist for onboarding'
-```
-
-### Safe automation mode
-
-Adds guardrails: max turns + budget cap.
-
-```bash
-make safe-print PROMPT='write unit tests for changed files'
-```
-
-## 5) Session Control (High Leverage)
-
-### Continue latest session in current working directory
-
-```bash
-make continue
-```
-
-### Resume by ID or search text
-
-```bash
-make resume SESSION='a3f0c2...'
-make resume SESSION='feature login review'
-```
-
-These map to CLI flags in [main.tsx](main.tsx):
-
-- `--continue`
-- `--resume [value]`
-
-## 6) Quality, Diagnostics, and Setup
-
-### Health and setup
-
-```bash
-make doctor
-make init
-```
-
-These run slash commands in session:
-
-- `/doctor` for diagnostics
-- `/init` for project onboarding/instructions
-
-Both are registered in [commands.ts](commands.ts).
-
-### Authentication status
-
-```bash
-make auth-status
-```
-
-### Debug session
-
-```bash
-make debug-run
-```
-
-## 7) MCP and Plugin Operations
-
-### Run local MCP server
-
-```bash
-make mcp-serve
-```
-
-### List installed plugins
-
-```bash
-make plugins
-```
-
-For full plugin and marketplace lifecycle, use CLI subcommands from [main.tsx](main.tsx), such as:
-
-- `plugin list`
-- `plugin install`
-- `plugin uninstall`
-- `marketplace add`
-- `marketplace list`
-- `marketplace update`
-
-## 8) Power User Workflows
-
-### A) Tight implementation loop
-
-1. Launch interactive session:
-
-```bash
-make run
-```
-
-2. Ask agent to implement feature in small increments.
-3. Ask for tests and a final verification pass.
-4. Use `make continue` for next session to preserve momentum.
-
-### B) Scriptable review helper
-
-```bash
-make safe-print PROMPT='review staged changes and output a risk checklist'
-```
-
-### C) Cost-aware exploration
-
-Use short one-shot prompts first:
-
-```bash
-make print PROMPT='list only top 5 refactor opportunities'
-```
-
-Then switch to full interactive only when needed.
-
-### D) Worktree-isolated tasks
-
-```bash
-make worktree NAME=feature-auth-hardening
-```
-
-This maps to `--worktree` (see [main.tsx](main.tsx)).
-
-## 9) Recommended Prompt Patterns
-
-### For architecture understanding
-
-- "Map the runtime flow from CLI entry to tool execution."
-- "Explain how command registration and feature gates interact."
-
-### For changes with fewer regressions
-
-- "Propose changes first as a concise plan, then implement and run checks."
-- "Keep edits minimal and avoid unrelated formatting changes."
-
-### For safer automation
-
-- "Stop if cost exceeds budget and return what remains."
-- "Prefer read-only analysis first, then patch in one pass."
-
-## 10) Cost and Performance Playbook
-
-1. Prefer `--print` for focused tasks.
-2. Use `--max-turns` and `--max-budget-usd` for bounded runs.
-3. Keep prompts scoped to explicit files/components.
-4. Use bare mode for lower startup complexity.
-5. Resume sessions instead of re-explaining context from scratch.
-
-## 11) Security and Safety Notes
-
-- Avoid `--dangerously-skip-permissions` unless you truly control the environment.
-- Keep API keys in environment variables, not committed files.
-- Use isolated worktrees for risky changes.
-- Review generated diffs before commit/push.
-
-## 12) Commands You Will Use Most
-
-```bash
-make help
-make run
-make bare
-make print PROMPT='...'
-make print-json PROMPT='...'
-make safe-print PROMPT='...'
-make continue
-make resume SESSION='...'
-make doctor
-make init
-make proxy-openrouter
-make run-openrouter
-make proxy-ollama
-make run-ollama
-make mcp-serve
-make plugins
-```
-
-## 13) Internal/Feature-Gated Items
-
-This codebase contains internal or feature-gated capabilities (for example some ant-only, bridge, or daemon paths in [commands.ts](commands.ts) and [main.tsx](main.tsx)).
-
-Treat them as non-default unless your environment explicitly enables them.
-
-## 14) Troubleshooting
-
-### "Command not found: anymodel"
-
-- Use `npx anymodel ...` (already baked into [Makefile](Makefile)).
-- Ensure Node/npm are installed and available in PATH.
-
-### "No auth / request failed"
-
-- Run `make auth-status`.
-- Ensure your selected provider credentials are present.
-
-### "Proxy started but client cannot connect"
-
-- Verify `ANTHROPIC_BASE_URL=http://localhost:9090` path via `make run-openrouter` or `make run-ollama`.
-- Make sure proxy terminal is still running.
-
-### "Ollama errors"
-
-- Start Ollama daemon first: `ollama serve`.
-- Ensure selected model exists locally.
-
-### "Session resume not finding what I expect"
-
-- Use explicit ID with `make resume SESSION='...'`.
-- Use `make continue` from the same working directory.
-
-## 15) Daily Best-Practice Checklist
-
-1. Start with `make print` for small tasks.
-2. Move to `make run` for multi-step changes.
-3. Keep a cost cap for unattended runs (`make safe-print`).
-4. Use worktrees for larger features.
-5. Reuse context with `make continue`.
-6. Use `make doctor` whenever behavior is odd.
-
----
-
-If you want an even more opinionated setup, customize [Makefile](Makefile) defaults (model, budget, turns, proxy model) to match your preferred daily workflow.