va-claw 0.1.0

package/packages/skills/dist/store.js

@@ -0,0 +1,75 @@
+import { access, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parseSkillMarkdown } from "./frontmatter.js";
+import { resolveInstalledSkillsDir, resolvePathInput, resolveSkillLookupDirs, toSkillFileName, } from "./paths.js";
+import { matchesSkillQuery } from "./search.js";
+export async function loadSkill(nameOrPath) {
+    const path = await resolveSkillPath(nameOrPath);
+    return readSkillFile(path);
+}
+export async function listSkills(dir) {
+    const skills = [];
+    const seen = new Set();
+    for (const lookupDir of resolveSkillLookupDirs(dir)) {
+        for (const skill of await readSkillsFromDir(lookupDir)) {
+            if (seen.has(skill.name)) {
+                continue;
+            }
+            seen.add(skill.name);
+            skills.push(skill);
+        }
+    }
+    return skills;
+}
+export async function installSkill(content, name) {
+    const skillPath = join(resolveInstalledSkillsDir(), toSkillFileName(name));
+    parseSkillMarkdown(content, skillPath);
+    await mkdir(resolveInstalledSkillsDir(), { recursive: true });
+    await writeFile(skillPath, content, "utf8");
+    return skillPath;
+}
+export async function removeSkill(name) {
+    await rm(join(resolveInstalledSkillsDir(), toSkillFileName(name)), { force: true });
+}
+export async function searchSkills(query) {
+    return (await listSkills()).filter((skill) => matchesSkillQuery(skill, query));
+}
+export function injectSkillIntoPrompt(skill, basePrompt) {
+    const prompt = basePrompt.trimEnd();
+    const skillBlock = [`[Skill: ${skill.name}@${skill.version}]`, skill.content.trim()].join("\n");
+    return prompt === "" ? skillBlock : `${prompt}\n\n${skillBlock}`;
+}
+async function resolveSkillPath(nameOrPath) {
+    const candidates = looksLikePath(nameOrPath)
+        ? [resolvePathInput(nameOrPath)]
+        : resolveSkillLookupDirs().map((dir) => join(dir, toSkillFileName(nameOrPath)));
+    for (const candidate of candidates) {
+        if (await exists(candidate)) {
+            return candidate;
+        }
+    }
+    throw new Error(`Skill not found: ${nameOrPath}`);
+}
+async function readSkillsFromDir(dir) {
+    if (!(await exists(dir))) {
+        return [];
+    }
+    const names = (await readdir(dir)).filter((entry) => entry.toLowerCase().endsWith(".md")).sort();
+    return Promise.all(names.map((name) => readSkillFile(join(dir, name))));
+}
+async function readSkillFile(path) {
+    return parseSkillMarkdown(await readFile(path, "utf8"), path);
+}
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function looksLikePath(value) {
+    return /[\\/]/.test(value) || value.startsWith(".") || value.startsWith("~") || value.endsWith(".md");
+}
+//# sourceMappingURL=store.js.map

package/packages/skills/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}

package/packages/skills/dist/types.d.ts

@@ -0,0 +1,9 @@
+export type SkillDefinition = {
+    name: string;
+    description: string;
+    version: string;
+    triggers: string[];
+    content: string;
+    path: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/packages/skills/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC"}

package/packages/skills/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/packages/skills/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/packages/skills/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@va-claw/skills",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -b",
+    "test": "pnpm run build && node --test dist/*.test.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  }
+}

package/skills/install-va-claw.md

@@ -0,0 +1,180 @@
+---
+name: install-va-claw
+description: Install and configure va-claw — persistent memory, identity, and wake-loop for Claude Code, OpenCode, or Codex
+version: 1.0.0
+triggers:
+  - install va-claw
+  - setup va-claw
+  - va-claw
+  - persistent memory
+  - wake loop
+  - agent memory
+---
+
+# Install va-claw
+
+va-claw gives your CLI agent (Claude Code / OpenCode / Codex) persistent memory, a custom identity, and a scheduled wake-loop — turning it into a continuously running autonomous agent.
+
+## Prerequisites check
+
+First verify Node.js version (must be ≥22):
+
+```bash
+node --version
+```
+
+Also verify you have at least one supported CLI agent installed:
+
+```bash
+# Check Claude Code
+claude --version 2>/dev/null && echo "✓ Claude Code found" || echo "✗ Claude Code not found"
+
+# Check OpenCode
+opencode --version 2>/dev/null && echo "✓ OpenCode found" || echo "✗ OpenCode not found"
+
+# Check Codex
+codex --version 2>/dev/null && echo "✓ Codex found" || echo "✗ Codex not found"
+```
+
+## Step 1 — Install va-claw globally
+
+```bash
+npm install -g va-claw
+```
+
+Verify the installation:
+
+```bash
+va-claw --version
+```
+
+## Step 2 — Set up your identity
+
+Run the interactive identity wizard. This defines your agent's name, persona, system prompt, wake prompt, and loop schedule:
+
+```bash
+va-claw identity setup
+```
+
+You'll be asked to provide:
+- **Name**: Your agent's identity (e.g. "Nova")
+- **Persona**: Tone and style (e.g. "Precise, calm, senior engineer mindset")
+- **System prompt**: Base behavior (e.g. "Check memory before starting any task")
+- **Wake prompt**: What to do on each scheduled wake (e.g. "Review repo health and summarize what needs attention")
+- **Loop interval**: Cron expression (e.g. `0 * * * *` for hourly, `*/30 * * * *` for every 30 min)
+
+## Step 3 — Install identity into your CLI agents
+
+```bash
+# Install for all detected agents
+va-claw install
+
+# Or target a specific agent
+va-claw install --for claude-code
+va-claw install --for opencode
+va-claw install --for codex
+```
+
+This injects your identity into:
+- `~/.claude/CLAUDE.md` (Claude Code)
+- `~/.codex/instructions.md` (Codex)
+- OpenCode config (auto-detected)
+
+## Step 4 — Start the wake-loop daemon
+
+```bash
+va-claw start
+```
+
+Check it's running:
+
+```bash
+va-claw status
+```
+
+## Optional: Connect to Discord
+
+To receive wake outputs and send commands via Discord:
+
+```bash
+va-claw channel discord setup
+# Follow the prompts to enter your bot token and channel ID
+va-claw channel discord start
+```
+
+Get a Discord bot token at: https://discord.com/developers/applications
+
+## Optional: Connect to Telegram
+
+```bash
+va-claw channel telegram setup --token <your-bot-token>
+va-claw channel telegram start
+```
+
+Get a Telegram bot token from @BotFather: https://t.me/BotFather
+
+## Optional: Connect to Slack
+
+```bash
+va-claw channel slack setup \
+  --bot-token xoxb-your-bot-token \
+  --app-token xapp-your-app-token
+va-claw channel slack start
+```
+
+Create a Slack app at: https://api.slack.com/apps
+
+## Verify everything is working
+
+```bash
+# Check daemon status
+va-claw status
+
+# Check memory (should be empty initially)
+va-claw memory list
+
+# Manually trigger a wake cycle to test
+va-claw memory memorize "setup-complete" "va-claw installed and configured" --tags setup,milestone
+
+# Search memory
+va-claw memory recall "setup"
+```
+
+## Managing your agent
+
+```bash
+# Stop the daemon
+va-claw stop
+
+# Update your identity config
+va-claw identity edit
+
+# View what's in memory
+va-claw memory list
+va-claw memory recall "<query>"
+
+# Consolidate memory (prune forgotten, reinforce recent)
+va-claw memory consolidate
+
+# Get a memory reflection summary
+va-claw memory reflect
+
+# Uninstall (removes from CLI config files, stops daemon)
+va-claw uninstall
+```
+
+## Troubleshooting
+
+**"No CLI agent detected"**
+Make sure `claude`, `opencode`, or `codex` is in your PATH. You can also force a specific command:
+```bash
+VA_CLAW_CLI=claude-copilot va-claw start
+```
+
+**Wake loop not triggering**
+Check that your cron expression is valid. Use `va-claw status` to see last wake time.
+
+**Memory not persisting**
+Memory is stored at `~/.va-claw/memory.db`. Ensure the directory is writable.
+
+For more help: https://github.com/Vadaski/va-claw/issues

package/vendor/commander/index.d.ts

@@ -0,0 +1,16 @@
+export type ActionHandler = (...args: any[]) => void | Promise<void>;
+
+export class Command {
+  readonly commands: Command[];
+  constructor(name?: string);
+  name(value: string): this;
+  description(value: string): this;
+  showHelpAfterError(): this;
+  command(spec: string): Command;
+  argument(spec: string, description?: string): this;
+  option(flags: string, description?: string, defaultValue?: string): this;
+  action(handler: ActionHandler): this;
+  parseAsync(argv: string[]): Promise<void>;
+  helpInformation(): string;
+  opts(): Record<string, unknown>;
+}

package/vendor/commander/index.js

@@ -0,0 +1,110 @@
+class Command {
+  constructor(name = "") {
+    this._name = name;
+    this._description = "";
+    this._action = null;
+    this._arguments = [];
+    this._options = [];
+    this._parsedOptions = {};
+    this.commands = [];
+    this.parent = null;
+  }
+
+  name(value) { this._name = value; return this; }
+  description(value) { this._description = value; return this; }
+  showHelpAfterError() { return this; }
+
+  command(spec) {
+    const child = new Command(spec.trim().split(/\s+/)[0]);
+    child.parent = this;
+    this.commands.push(child);
+    return child;
+  }
+
+  argument(spec) {
+    this._arguments.push({ required: spec.startsWith("<"), name: spec.slice(1, -1) });
+    return this;
+  }
+
+  option(flags, _description, defaultValue) {
+    const long = flags.match(/--([a-z0-9-]+)/i)?.[1];
+    if (!long) throw new Error(`Unsupported option flags: ${flags}`);
+    const key = long.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+    this._options.push({ key, flag: `--${long}`, requiresValue: /<.+>/.test(flags), defaultValue });
+    return this;
+  }
+
+  action(handler) { this._action = handler; return this; }
+  opts() { return { ...this._parsedOptions }; }
+
+  async parseAsync(argv) {
+    await this._dispatch(argv.slice(2));
+  }
+
+  async _dispatch(tokens) {
+    if (tokens.includes("--help") || tokens.includes("-h")) {
+      process.stdout.write(`${this.helpInformation()}\n`);
+      return;
+    }
+    const child = tokens[0] ? this.commands.find((command) => command._name === tokens[0]) : null;
+    if (child) {
+      await child._dispatch(tokens.slice(1));
+      return;
+    }
+    const { options, positionals } = this._parseTokens(tokens);
+    this._parsedOptions = options;
+    const required = this._arguments.filter((argument) => argument.required).length;
+    if (positionals.length < required) {
+      throw new Error(`Missing required argument for ${this._commandPath()}.`);
+    }
+    if (!this._action) {
+      process.stdout.write(`${this.helpInformation()}\n`);
+      return;
+    }
+    await this._action(...positionals, options, this);
+  }
+
+  _parseTokens(tokens) {
+    const options = Object.fromEntries(this._options.map((option) => [option.key, option.defaultValue]));
+    const positionals = [];
+    for (let index = 0; index < tokens.length; index += 1) {
+      const token = tokens[index];
+      const option = this._options.find((entry) => entry.flag === token);
+      if (!option) {
+        positionals.push(token);
+        continue;
+      }
+      options[option.key] = option.requiresValue ? tokens[++index] : true;
+    }
+    return { options, positionals };
+  }
+
+  helpInformation() {
+    const lines = [`Usage: ${this._commandPath()}${this.commands.length ? " [command]" : ""}`];
+    if (this._description) lines.push("", this._description);
+    const commands = this._flattenCommands();
+    if (commands.length) {
+      lines.push("", "Commands:");
+      for (const entry of commands) lines.push(`  ${entry}`);
+    }
+    return lines.join("\n");
+  }
+
+  _flattenCommands(prefix = "") {
+    const nextPrefix = prefix ? `${prefix} ${this._name}`.trim() : this._name;
+    return this.commands.flatMap((command) => {
+      const label = `${nextPrefix} ${command._name}`.trim();
+      return [label, ...command._flattenCommands(nextPrefix)];
+    });
+  }
+
+  _commandPath() {
+    const names = [];
+    for (let current = this; current; current = current.parent) {
+      if (current._name) names.push(current._name);
+    }
+    return names.reverse().join(" ");
+  }
+}
+
+export { Command };

package/vendor/commander/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "commander",
+  "version": "14.0.0-local",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    }
+  }
+}

package/vendor/croner/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-2021 Hexagon <github.com/Hexagon>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+