@wrongstack/cli 0.1.3 → 0.1.7

package/LICENSE

@@ -1,17 +1,21 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
+MIT License
 
-   Copyright 2026 ECOSTACK TECHNOLOGY OÜ
+Copyright (c) 2026 ECOSTACK TECHNOLOGY OÜ
 
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
+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:
 
-       http://www.apache.org/licenses/LICENSE-2.0
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
+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,98 @@
+# @wrongstack/cli
+
+The terminal binary for WrongStack. Provides the `wstack` and `wrongstack` commands.
+
+Most users don't depend on this package directly — they install [`wrongstack`](../../README.md) (the umbrella) and run `wrongstack` / `wstack` from any project directory.
+
+## Install
+
+```bash
+npm install -g wrongstack
+```
+
+The `wrongstack` umbrella package transitively installs `@wrongstack/cli` along with `core`, `providers`, `tools`, `mcp`, and `tui`.
+
+## Commands
+
+```bash
+wstack                        # interactive REPL — no flags = default
+wstack --tui                  # Ink-based TUI
+wstack --yolo                 # auto-approve every tool call
+wstack "refactor src/auth.ts" # one-shot query (no interactive loop)
+
+wstack --provider <id> --model <id>   # skip the picker
+wstack --resume <session-id>          # resume a saved session
+wstack resume <session-id>            # equivalent
+
+wstack init                   # interactive provider+model wizard
+wstack doctor                 # config/key/MCP/Node health check
+wstack export <session-id>    # render a session as markdown/JSON/plain text
+wstack mcp add <preset>       # add an MCP server (see @wrongstack/mcp)
+wstack mcp list               # show configured MCP servers
+```
+
+`--no-tui` forces REPL mode even when `--tui` is configured globally. `--alt-screen` opts into Ink's alt-screen rendering (off by default so the user keeps native scrollback).
+
+## Slash commands inside the REPL/TUI
+
+```
+/help                # list of commands
+/help <name>         # detailed help for one command
+/clear               # wipe context + memory + visible history
+/model               # change model mid-session
+/use <provider>      # switch provider
+/mode <id>           # activate a mode (debugger, code-reviewer, …)
+/memory              # show/edit project memory
+/skill [name]        # list skills / show a specific skill
+/context             # show token usage breakdown
+/sessions            # list past sessions
+/resume <id>         # resume a session
+/exit                # quit
+```
+
+## Configuration
+
+```
+~/.wrongstack/config.json            global config (provider, model defaults, features)
+~/.wrongstack/.key                   AES-256-GCM secret-vault key (mode 0600)
+~/.wrongstack/memory.md              user-global memory
+~/.wrongstack/skills/                user-global skills
+~/.wrongstack/projects/<hash>/       per-project state
+  memory.md                          project memory (auto-gitignored)
+  sessions/                          JSONL session logs
+  trust.json                         per-project tool/permission trust
+.wrongstack/AGENTS.md                committable project memory
+.wrongstack/skills/                  committable project skills
+```
+
+API keys are encrypted at rest with AES-256-GCM and the key file at `~/.wrongstack/.key`. The vault auto-bootstraps on first run; the key never leaves the machine.
+
+## Flags
+
+| Flag | Effect |
+|------|--------|
+| `--tui` / `--no-tui` | Force/disable Ink TUI |
+| `--yolo` | Auto-approve every tool call (use with care) |
+| `--provider <id>` | Override the configured provider |
+| `--model <id>` | Override the configured model |
+| `--resume <id>` | Resume a saved session by id |
+| `--alt-screen` | Opt into alt-screen TUI rendering |
+| `--config <path>` | Use a non-default config file |
+| `--debug` | Verbose logging to `~/.wrongstack/logs/wrongstack.log` |
+| `--version` | Print version |
+| `--help` | Print help |
+
+## Environment variables
+
+| Variable | Purpose |
+|----------|---------|
+| `WRONGSTACK_BASH_ENV_PASSTHROUGH=1` | Disable the bash-tool env allowlist (legacy unsafe mode — see [SECURITY.md](../../SECURITY.md)) |
+| `WRONGSTACK_CONFIG_DIR` | Override `~/.wrongstack` location |
+| `WRONGSTACK_DEBUG=1` | Same as `--debug` |
+| `NO_COLOR=1` | Disable ANSI colors |
+
+Provider API keys can be set via env (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, …) or stored encrypted via `wstack` first-run wizard.
+
+## License
+
+MIT