va-claw 0.1.0

package/CONTRIBUTING.md

@@ -0,0 +1,36 @@
+# Contributing
+
+Thanks for your interest in va-claw.
+
+## Local development
+
+- `pnpm install`
+- `pnpm build`
+- `pnpm test`
+
+Run all three before opening a pull request.
+
+## Code standards
+
+- TypeScript strict mode
+- ESM modules
+- Keep each source file under 200 lines when editing/adding
+- Prefer clear CLI output and concise implementation
+
+## Issues
+
+- For bugs, use the bug report issue template and include reproducible steps.
+- For feature ideas, use the feature request template.
+- If a report is missing required information, we may ask follow-up questions before triage.
+
+## Pull requests
+
+- One PR should focus on one topic.
+- Keep the scope small and explicit.
+- Link related issues where applicable.
+- CI/tests must pass before merge.
+- Include any behavior changes in docs when needed.
+
+## Questions
+
+Open an issue if you are unsure about command behavior or expected configuration.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Vadaski
+
+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.

package/README.md

@@ -0,0 +1,337 @@
+<h1 align="center">va-claw</h1>
+
+<p align="center">
+  <b>Turn your Claude Code or OpenCode into an OpenClaw — in 30 seconds.</b>
+</p>
+
+<p align="center">
+  <a href="https://github.com/Vadaski/va-claw/actions/workflows/ci.yml">
+    <img src="https://github.com/Vadaski/va-claw/actions/workflows/ci.yml/badge.svg" alt="CI">
+  </a>
+  <a href="https://www.npmjs.com/package/va-claw">
+    <img src="https://img.shields.io/npm/v/va-claw.svg" alt="npm">
+  </a>
+  <a href="LICENSE">
+    <img src="https://img.shields.io/github/license/Vadaski/va-claw.svg" alt="License">
+  </a>
+  <a href="https://www.npmjs.com/package/va-claw">
+    <img src="https://img.shields.io/npm/dm/va-claw.svg" alt="Downloads">
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://vadaski.github.io/va-claw">🌐 Website</a> •
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#how-it-works">How It Works</a> •
+  <a href="#features">Features</a> •
+  <a href="#channels">Channels</a> •
+  <a href="#vs-openclaw">vs OpenClaw</a>
+</p>
+
+---
+
+## What is va-claw?
+
+**va-claw** is a minimal plugin that adds OpenClaw's three core superpowers to any CLI agent you already have:
+
+| | Without va-claw | With va-claw |
+|---|---|---|
+| **Memory** | Session resets every time | Persistent SQLite memory, semantic search |
+| **Identity** | Generic assistant | Named persona injected into every session |
+| **Wake Loop** | You have to prompt it | Scheduled daemon wakes the agent for you |
+
+> *No new gateway. No new CLI to learn. Just install the plugin and your existing `claude` or `codex` becomes persistent, self-aware, and autonomous.*
+
+---
+
+## Install via Skill (zero-effort setup)
+
+The fastest way to install va-claw is to drop the install skill into any Claude Code or OpenCode session. The agent will handle everything — checking prerequisites, running the install, configuring identity, and starting the daemon.
+
+```bash
+# In any Claude Code or OpenCode session, run:
+/install https://raw.githubusercontent.com/Vadaski/va-claw/main/skills/install-va-claw.md
+```
+
+Or add it as a persistent skill so any future agent can self-install va-claw:
+
+```bash
+va-claw skill add https://raw.githubusercontent.com/Vadaski/va-claw/main/skills/install-va-claw.md
+```
+
+---
+
+## Quick Start
+
+### Prerequisites
+
+- **Node.js** >= 22
+- **Claude Code** (`npm install -g @anthropic-ai/claude-code`) or **OpenCode / Codex** installed
+
+### Install & go
+
+```bash
+npm install -g va-claw
+va-claw install        # injects identity into ~/.claude/CLAUDE.md or ~/.codex/instructions.md
+va-claw start          # starts the wake-loop daemon
+```
+
+That's it. Your CLI agent now has memory, an identity, and runs autonomously in the background.
+
+### First steps
+
+```bash
+# See what your agent has been doing
+va-claw memory list
+
+# Search across all past wake outputs
+va-claw memory recall "what was I working on"
+
+# Check daemon health
+va-claw status
+```
+
+---
+
+## How It Works
+
+```
+ ┌──────────────────┐       ┌──────────────────┐
+ │   Claude Code    │       │  OpenCode/Codex  │
+ └────────┬─────────┘       └────────┬─────────┘
+          │  identity injected        │  identity injected
+          │  via CLAUDE.md / instructions.md
+          └──────────┬───────────────┘
+                     │
+          ┌──────────▼───────────┐
+          │    va-claw Daemon    │
+          │                      │
+          │  ┌────────────────┐  │
+          │  │  Wake Loop     │  │  ← cron schedule, runs silently
+          │  │  (croner)      │  │
+          │  └───────┬────────┘  │
+          │          │           │
+          │  ┌───────▼────────┐  │
+          │  │  Memory Store  │  │  ← SQLite, ~/.va-claw/memory.db
+          │  │  (node:sqlite) │  │
+          │  └───────┬────────┘  │
+          │          │           │
+          │  ┌───────▼────────┐  │
+          │  │  Skills Layer  │  │  ← Markdown-based, zero compile
+          │  └────────────────┘  │
+          └──────────────────────┘
+                     │
+         ┌───────────┼───────────┐
+         │           │           │
+    ┌────▼────┐ ┌────▼────┐ ┌───▼─────┐
+    │ Discord │ │Telegram │ │  Slack  │
+    └─────────┘ └─────────┘ └─────────┘
+```
+
+**One daemon. Local SQLite. Zero cloud dependency.** Wake outputs are automatically stored in memory so your next session always has context.
+
+---
+
+## Features
+
+### 🧠 Memory
+
+Structured SQLite memory with full CRUD, Ebbinghaus forgetting curve, and weighted recall. Your agent doesn't just log outputs — it remembers, forgets, and gets smarter over time.
+
+**Store a named memory:**
+
+```bash
+va-claw memory memorize "auth-pattern" \
+  "Always use JWT with 1h expiry and refresh token rotation" \
+  --tags auth,security \
+  --importance 0.9 \
+  --details "Single-use refresh tokens mandatory after Feb incident"
+```
+
+**Full CRUD:**
+
+```bash
+va-claw memory get auth-pattern                        # retrieve by key
+va-claw memory update auth-pattern --importance 1.0    # patch fields
+va-claw memory forget auth-pattern                     # delete one memory
+va-claw memory clear                                   # wipe all
+```
+
+**Recall:**
+
+```bash
+va-claw memory recall "JWT authentication"   # weighted: tags > triggers > essence > details
+va-claw memory list --limit 20               # recent entries
+```
+
+**Maintenance (Ebbinghaus model):**
+
+```bash
+va-claw memory consolidate   # prune faded memories, reinforce recently accessed
+va-claw memory reflect       # Markdown summary grouped by tag
+```
+
+Every memory has `strength`, `importance`, and `decayTau`. High-importance memories decay ~3× slower. Accessing a memory reinforces it. `consolidate` runs the forgetting curve and cleans up dead entries automatically.
+
+### 🎭 Identity
+
+Define your agent's name, persona, and behavior once — injected automatically into every Claude Code or OpenCode session.
+
+```bash
+va-claw identity setup    # interactive wizard
+va-claw identity show     # view current config
+```
+
+Config lives at `~/.va-claw/config.json`:
+
+```json
+{
+  "name": "Nova",
+  "persona": "Precise and calm. Senior engineer mindset.",
+  "systemPrompt": "Act with continuity. Check memory before starting.",
+  "wakePrompt": "Check repo status and summarize what needs attention.",
+  "loopInterval": "0 * * * *"
+}
+```
+
+### ⏰ Wake Loop
+
+A local cron daemon that wakes your agent on a schedule and writes the output back into memory.
+
+```bash
+va-claw start      # start the daemon
+va-claw stop       # stop the daemon
+va-claw status     # check health + last wake time
+```
+
+Use cases: daily standup summaries, repo health checks, automated PR reviews, background research.
+
+---
+
+## Skills
+
+Extend behavior with plain Markdown files — no compilation, no config:
+
+```bash
+va-claw skill add ./my-skill.md                          # local file
+va-claw skill add https://example.com/skills/git.md      # remote URL
+
+va-claw skill list
+va-claw skill show <name>
+va-claw skill remove <name>
+```
+
+A skill file looks like this:
+
+```markdown
+---
+name: git-hygiene
+description: Check for stale branches and large commits
+version: 1.0.0
+triggers:
+  - git
+  - branch
+  - commit
+---
+
+When checking the repository, always:
+1. List branches older than 30 days
+2. Flag commits larger than 500 lines
+3. Suggest a cleanup plan
+```
+
+---
+
+## Channels
+
+Connect your wake loop to Discord, Telegram, or Slack to receive outputs and send commands remotely.
+
+### Discord
+
+```bash
+va-claw channel discord setup
+va-claw channel discord start
+va-claw channel discord status
+```
+
+### Telegram
+
+```bash
+va-claw channel telegram setup --token <bot-token>
+va-claw channel telegram start
+```
+
+### Slack
+
+```bash
+va-claw channel slack setup --bot-token <xoxb-...> --app-token <xapp-...>
+va-claw channel slack start
+```
+
+---
+
+## Full CLI Reference
+
+```bash
+# Core
+va-claw install [--for claude-code|codex|all]
+va-claw start | stop | status | uninstall
+
+# Identity
+va-claw identity setup | show | edit
+
+# Memory — full CRUD + Ebbinghaus lifecycle
+va-claw memory memorize <key> <essence> [--tags t1,t2] [--details "..."] [--importance 0-1]
+va-claw memory get <key>
+va-claw memory update <key> [--essence "..."] [--tags "..."] [--importance 0-1] [--details "..."]
+va-claw memory forget <key>
+va-claw memory recall <query> [--limit <n>]
+va-claw memory list [--limit <n>]
+va-claw memory consolidate
+va-claw memory reflect
+va-claw memory clear
+
+# Skills
+va-claw skill list | add <path-or-url> | remove <name> | show <name>
+
+# Channels
+va-claw channel discord  setup | start | stop | status
+va-claw channel telegram setup --token <t> | start | stop | status
+va-claw channel slack    setup --bot-token <t> --app-token <t> | start | stop | status
+```
+
+---
+
+## vs OpenClaw
+
+| | **va-claw** | **OpenClaw** |
+|---|---|---|
+| **Concept** | Plugin for your existing CLI | Standalone AI agent system |
+| **Install** | `npm install -g va-claw` | Full gateway setup |
+| **Agents** | Claude Code, OpenCode, Codex | Own runtime |
+| **Memory** | SQLite (local) | SQLite + Markdown compaction |
+| **Channels** | Discord, Telegram, Slack | WhatsApp, iMessage, + more |
+| **Footprint** | ~2 MB, zero cloud deps | Full service stack |
+| **Best for** | Devs who already use Claude Code / Codex | Users who want a dedicated agent |
+
+**va-claw = OpenClaw's soul, Claude Code's body.** If you're already paying for Claude Code or OpenCode, don't run a separate agent stack — just add the three superpowers you're missing.
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/Vadaski/va-claw.git
+cd va-claw
+pnpm install
+pnpm build
+pnpm test
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.
+
+---
+
+## License
+
+[MIT](LICENSE) © Vadaski

package/bin/va-claw

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { runCli } from "../packages/cli/dist/index.js";
+await runCli();

package/bin/va-claw.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { runCli } from "../packages/cli/dist/index.js";
+await runCli();

package/docs/README.md

@@ -0,0 +1,6 @@
+# va-claw Documentation
+
+This repository's main documentation is in the project root:
+
+- [Main README](../README.md)
+