lazyclaw 3.88.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Claude Control Center contributors
+
+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,186 @@
+# 🦞 lazyclaw
+
+[![npm](https://img.shields.io/npm/v/lazyclaw.svg)](https://www.npmjs.com/package/lazyclaw)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+[![Node](https://img.shields.io/badge/node-%E2%89%A518-blue.svg)](https://nodejs.org/)
+
+**A lazy, elegant terminal CLI for Claude / OpenAI / Gemini / Ollama.**
+
+One Node CLI that talks to every major LLM provider, runs multi-step workflows as a DAG, exposes a local HTTP gateway, and ships with the niceties you actually want at the prompt: an ASCII banner on launch, Cursor-style slash-command ghost autocomplete (right-arrow accepts), persistent chat sessions, and cost rate cards.
+
+> Part of the [LazyClaude](https://github.com/cmblir/LazyClaude) project — published standalone so you can `npm i -g lazyclaw` without cloning the dashboard.
+
+---
+
+## Install
+
+```bash
+npm install -g lazyclaw
+lazyclaw version
+```
+
+Requires **Node 18+**. Works on macOS / Linux / WSL. Windows native PowerShell mostly works but the ghost-text + ANSI banner are TTY-gated and may fall back to plain prompts.
+
+## First run
+
+```bash
+lazyclaw onboard         # guided: provider, model, api-key
+lazyclaw status          # current provider/model + masked key
+lazyclaw doctor          # validate config + provider registry
+```
+
+`onboard` writes `~/.lazyclaw/config.json`. Move it with `LAZYCLAW_CONFIG_DIR=/elsewhere`. For automation: `--non-interactive --provider X --model Y --api-key Z`.
+
+## Interactive chat
+
+```bash
+lazyclaw chat                      # banner + active provider/model + REPL
+lazyclaw chat --pick               # arrow-key picker before the prompt
+lazyclaw chat --session daily      # persist turns to ~/.lazyclaw/sessions/daily.jsonl
+lazyclaw chat --skill review,style # compose named skills as the system prompt
+```
+
+What you see on launch (TTY only):
+
+```text
+  ╭──────────────────────────────╮
+  │   _                          │
+  │  | |__ _ _____  _ _          │
+  │  | / _` |_ / || | '_|         │
+  │  |_\__,_/__\_, |_|            │
+  │  LazyClaw  |__/  3.88.0      │
+  ╰──────────────────────────────╯
+
+  provider · anthropic
+  model    · claude-opus-4-7
+  slash    · /help · /model · /provider · /exit
+  hint     · → to accept the suggested command, Tab to cycle
+
+›
+```
+
+Slash commands inside the REPL:
+
+| Slash | What it does |
+|---|---|
+| `/help` | List slash commands |
+| `/status` | Print provider + model + masked key |
+| `/provider X` | Switch active provider mid-session (history kept) |
+| `/model X` | Switch model. Accepts unified `provider/model` form |
+| `/skill a,b` | Replace the system prompt with a composition of named skills |
+| `/usage` | Message count + chars + cumulative token totals |
+| `/new` / `/reset` | Wipe history and start over |
+| `/exit` | Quit |
+
+**Cursor-style ghost autocomplete**: type `/` and the longest matching slash command appears in dim grey after the cursor. **`→`** accepts; **`Tab`** cycles. **Ctrl-C** during a streaming reply aborts that turn (not the whole process); **Ctrl-C** at an empty prompt exits.
+
+## One-shot (no REPL)
+
+```bash
+lazyclaw agent "summarize: $(cat file.md)"
+lazyclaw agent - < prompt.txt                 # stdin
+lazyclaw agent "..." --provider openai --model gpt-4.1
+lazyclaw agent "..." --skill review           # compose system prompt
+lazyclaw agent "..." --usage                  # token counts on stderr
+lazyclaw agent "..." --cost                   # USD when rates configured
+```
+
+## Providers / sessions / skills
+
+```bash
+lazyclaw providers list                       # all registered providers
+lazyclaw providers info anthropic
+lazyclaw providers test anthropic             # 1-token reachability probe
+
+lazyclaw sessions list                        # persisted chats
+lazyclaw sessions show daily
+lazyclaw sessions search "deploy"
+lazyclaw sessions export daily > daily.md
+lazyclaw sessions clear daily
+
+lazyclaw skills list                          # markdown skill bundles
+lazyclaw skills show review
+lazyclaw skills install ./my-skill.md
+lazyclaw skills remove review
+```
+
+## Workflows (DAG / sequential / persistent)
+
+```bash
+lazyclaw run my-job ./flow.mjs                              # sequential, resumable
+lazyclaw run my-job ./flow.mjs --parallel --concurrency 4   # in-memory DAG
+lazyclaw run my-job ./flow.mjs --parallel-persistent        # DAG + checkpoints
+lazyclaw resume my-job ./flow.mjs                           # resume a stalled run
+
+lazyclaw inspect                                            # list every session
+lazyclaw inspect my-job --summary
+lazyclaw inspect my-job --critical-path ./flow.mjs          # bottleneck finder
+lazyclaw inspect my-job --slowest 5
+```
+
+State at `./.workflow-state/<id>/` (override with `LAZYCLAW_WORKFLOW_STATE_DIR=...`).
+
+## Local HTTP gateway
+
+```bash
+lazyclaw daemon                               # bind a free port; prints { port, url }
+lazyclaw daemon --port 19600
+lazyclaw daemon --auth-token $(openssl rand -hex 16)
+lazyclaw daemon --rate-limit 60 --log info    # 60 req/min/IP, JSON access logs
+lazyclaw daemon --once                        # serve a single request, then exit
+```
+
+## Cost rate cards
+
+```bash
+lazyclaw rates list
+lazyclaw rates set anthropic/claude-opus-4-7 \
+  --in 15 --out 75 --cache-read 1.5 --cache-create 18.75
+lazyclaw rates copy anthropic/claude-opus-4-7 anthropic/claude-opus-4-6
+lazyclaw rates delete openai/gpt-3.5-turbo
+lazyclaw rates validate
+```
+
+`/usage` and `--cost` use these to compute USD totals locally — no provider call.
+
+## Config + bundles
+
+```bash
+lazyclaw config path                          # → ~/.lazyclaw/config.json
+lazyclaw config get provider
+lazyclaw config set provider openai
+lazyclaw config list
+lazyclaw config edit                          # opens $EDITOR
+lazyclaw config validate
+
+lazyclaw export > backup.json                 # config + skills (+ optional sessions)
+lazyclaw import --from backup.json
+```
+
+## Shell completion
+
+```bash
+lazyclaw completion bash >> ~/.bashrc
+lazyclaw completion zsh  >> ~/.zshrc
+```
+
+## File locations
+
+| Path | Purpose |
+|---|---|
+| `~/.lazyclaw/config.json` | provider, model, api-key, skills, rates |
+| `~/.lazyclaw/sessions/*.jsonl` | persisted chat sessions |
+| `~/.lazyclaw/skills/*.md` | installed skill bundles |
+| `./.workflow-state/<id>/` | per-session workflow checkpoints (cwd-relative) |
+
+`LAZYCLAW_CONFIG_DIR=...` moves the first three; `LAZYCLAW_WORKFLOW_STATE_DIR=...` moves the last.
+
+---
+
+## Issues / contributing
+
+Source lives in [cmblir/LazyClaude](https://github.com/cmblir/LazyClaude) under [`src/lazyclaw/`](https://github.com/cmblir/LazyClaude/tree/main/src/lazyclaw). Issues and PRs welcome on the parent repo.
+
+## License
+
+[MIT](./LICENSE)