drexler 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## 0.2.0
+
+- Added premium Ink chat chrome with responsive header, transcript viewport, command palette, input, live spinner, and streaming response states.
+- Added expanded theme pack: `terminal`, `dealroom`, `midnight`, `paper`, and `plasma`.
+- Added persisted UI preferences through `/theme <name> save`, `/theme save`, and `/startup fast|no-intro|normal`.
+- Added transcript search, markdown/text/json/html export, save-last, copy-last, expand, quote, and styled retry commands.
+- Added first-run Ink setup prompt with masked API key entry and inline validation.
+- Added fast startup controls via `--fast`, `--no-intro`, `DREXLER_FAST`, and `DREXLER_NO_INTRO`.
+- Improved narrow-terminal handling, scrollback, grapheme-aware input editing, and live response clipping.
+- Expanded tests across commands, UI components, App state helpers, themes, config, and release smoke paths.

package/README.md

@@ -1,84 +1,217 @@
 # Drexler
 
+[![npm version](https://img.shields.io/npm/v/drexler.svg)](https://www.npmjs.com/package/drexler)
+[![license](https://img.shields.io/npm/l/drexler.svg)](./LICENSE)
+[![bun](https://img.shields.io/badge/runtime-bun%20%E2%89%A5%201.1-black)](https://bun.sh)
+
 CLI chat with **Drexler**, a corporate-executive AI persona who speaks in broken third-person and treats every conversation like a hostile takeover. Built with Bun + TypeScript. Talks to OpenRouter's Gemma 4 31B model (paid).
 
 > "Drexler usually charge consulting fee for this. Today, pro bono. You welcome."
 
+---
+
+## Quickstart
+
+```bash
+bun add -g drexler
+drexler
+```
+
+That's it. First launch prompts for an OpenRouter API key (free at <https://openrouter.ai/keys>) and remembers it. Subsequent launches skip the prompt.
+
+---
+
 ## Install
 
-Requires [Bun](https://bun.sh) ≥ 1.1. One command:
+### 1. Install Bun (skip if already installed)
+
+Bun ≥ 1.1 is required. Install once per machine:
+
+| Platform        | Command                                                              |
+| --------------- | -------------------------------------------------------------------- |
+| **macOS/Linux** | `curl -fsSL https://bun.sh/install \| bash`                          |
+| **Homebrew**    | `brew install oven-sh/bun/bun`                                       |
+| **Windows**     | `powershell -c "irm bun.sh/install.ps1 \| iex"`                      |
+| **npm**         | `npm install -g bun`                                                 |
+
+Verify: `bun --version` → should print `1.1.0` or higher.
+
+### 2. Install Drexler globally
 
 ```bash
 bun add -g drexler
 ```
 
-Then anywhere:
+This installs the `drexler` command into `~/.bun/bin/drexler`. Make sure `~/.bun/bin` is on your `$PATH` (Bun's installer does this automatically; if not, add `export PATH="$HOME/.bun/bin:$PATH"` to your shell rc).
+
+### 3. Run it
 
 ```bash
 drexler
 ```
 
-First launch prompts for an OpenRouter API key (free at <https://openrouter.ai/keys>) and saves it to `~/.config/drexler/config.json`. No further setup.
+On first run you'll see:
+
+```
+Drexler notice no API key on file. Even CEO need credentials.
+Get free key at: https://openrouter.ai/keys
+Enter OpenRouter API key:
+```
 
-### Update
+Paste the key, hit return. Drexler saves it to `~/.config/drexler/config.json` (mode `0600`) and boots into the chat. Done.
+
+---
+
+## Update
 
 ```bash
 bun update -g drexler
 ```
 
-### Uninstall
+## Uninstall
 
 ```bash
 bun remove -g drexler
 rm -rf ~/.config/drexler   # optional: wipe stored key + settings
 ```
 
-## From source (dev)
+---
+
+## Usage
+
+### Flags
+
+| flag                              | what                                                              |
+| --------------------------------- | ----------------------------------------------------------------- |
+| `--model <31b\|26b\|vendor/name>` | switch model (alias or full OpenRouter id, e.g. `google/gemma-4-31b-it`) |
+| `--persona <path>`                | load a custom persona markdown file instead of bundled `drexler.md` |
+| `--theme <name>`                  | color theme (default `apollo`)                                    |
+| `--no-intro`                      | skip the startup banner and mascot                                |
+| `--fast`                          | fast startup mode, implies `--no-intro`                           |
+| `--version`, `-v`                 | print version                                                     |
+| `--help`, `-h`                    | print usage                                                       |
+
+### Slash commands (inside the REPL)
+
+| cmd            | what it do                                       |
+| -------------- | ------------------------------------------------ |
+| `/help`        | list directives                                  |
+| `/clear`       | shred conversation history (system prompt pinned) |
+| `/exit`        | meeting adjourned                                |
+| `/synergy`     | SYNERGY!                                         |
+| `/model`       | show current model, or `/model 26b` to switch   |
+| `/theme`       | show/switch theme; append `save` to persist, e.g. `/theme midnight save` |
+| `/startup fast\|no-intro\|normal` | persist startup behavior for future launches |
+| `/history`     | message count + approx tokens                    |
+| `/regenerate`  | re-roll last response                            |
+| `/retry terse\|brutal` | re-roll last response with a style mandate |
+| `/expand`      | print Drexler's latest response                  |
+| `/quote`       | quote Drexler's latest response                  |
+| `/search <term>` | search the current transcript                 |
+| `/export md\|txt\|json\|html [path]` | export transcript       |
+| `/save [path]` | archive conversation as markdown                 |
+| `/save-last [path]` | save Drexler's last response only          |
+| `/copy-last`   | copy Drexler's latest response to the clipboard  |
 
-```bash
-git clone https://github.com/showOS/Drexler.git && cd Drexler
-bun install
-bun run start
-```
+`Ctrl+C` exits gracefully with an in-character farewell.
 
-Optional: `cp .env.example .env` and paste the key into `OPENROUTER_API_KEY=...` to skip the first-run prompt.
+---
 
-## Flags
+## Configuration
 
-- `--model <31b|26b|vendor/name:tag>` — switch model (alias or full OpenRouter id).
-- `--persona <path>` — load a custom persona markdown file instead of `prompts/drexler.md`.
+Drexler reads config in this priority (later wins):
+
+1. `~/.config/drexler/config.json` — written on first run
+2. Environment variables
+3. CLI flags
+
+### Environment variables
+
+| var                  | purpose                                              |
+| -------------------- | ---------------------------------------------------- |
+| `OPENROUTER_API_KEY` | API key (overrides config file)                      |
+| `DREXLER_MODEL`      | model id or alias                                    |
+| `DREXLER_THEME`      | color theme name                                     |
+| `DREXLER_NO_INTRO`   | `1`, `true`, `yes`, or `on` skips startup intro      |
+| `DREXLER_FAST`       | `1`, `true`, `yes`, or `on` enables fast startup     |
+| `XDG_CONFIG_HOME`    | override config dir (default `~/.config/drexler`)    |
+| `NO_COLOR`           | disable colors entirely                              |
+
+### Config file
+
+`~/.config/drexler/config.json`:
+
+```json
+{
+  "apiKey": "sk-or-v1-...",
+  "model": "google/gemma-4-31b-it",
+  "maxHistory": 50,
+  "personaPath": "/optional/path/to/custom-persona.md",
+  "theme": "apollo",
+  "noIntro": false,
+  "fast": false
+}
+```
 
-## Slash commands
+Default `maxHistory`: 50 messages.
 
-| cmd        | what it do                                  |
-| ---------- | ------------------------------------------- |
-| `/help`    | list directives                             |
-| `/clear`   | shred conversation history (system pinned)  |
-| `/exit`    | meeting adjourned                           |
-| `/synergy` | SYNERGY!                                    |
-| `/model`   | show current model, or `/model 26b` to switch |
-| `/history` | message count + approx tokens               |
+Available launch/config themes: `apollo`, `amber`, `mono`, `terminal`, `dealroom`, `midnight`, `paper`, and `plasma`.
+`NO_COLOR` always forces `mono`.
 
-`Ctrl+C` exits gracefully with an in-character farewell.
+---
 
-## Configuration
+## Models
 
-- Env: `OPENROUTER_API_KEY`, `DREXLER_MODEL` (optional override).
-- Config file: `~/.config/drexler/config.json` — keys: `apiKey`, `model`, `maxHistory`, `personaPath`.
-- Default `maxHistory`: 50.
+| alias  | id                                  | notes                          |
+| ------ | ----------------------------------- | ------------------------------ |
+| `31b`  | `google/gemma-4-31b-it`             | primary (paid)                 |
+| `26b`  | `google/gemma-4-26b-a4b-it`         | fallback, auto-retry on 429    |
 
-## Models
+Pass `--model vendor/name:tag` for any other OpenRouter-compatible model.
 
-- Primary: `google/gemma-4-31b-it` (paid)
-- Fallback: `google/gemma-4-26b-a4b-it` (paid, auto-retry on 429)
+---
 
-## Test
+## From source (development)
+
+```bash
+git clone https://github.com/showOS/Drexler.git
+cd Drexler
+bun install
+cp .env.example .env       # then edit, paste key into OPENROUTER_API_KEY=
+bun run start
+```
+
+### Tests + typecheck
 
 ```bash
 bun test
 bun run typecheck
 ```
 
+### Releasing a new version
+
+```bash
+npm version <patch|minor>  # bumps package.json, commits, tags
+git push --follow-tags     # CI publishes to npm automatically
+```
+
+The `.github/workflows/publish.yml` workflow runs typecheck + tests + `npm publish --provenance` on every `v*` tag push.
+
+---
+
+## Troubleshooting
+
+| symptom                                                    | fix                                                                                       |
+| ---------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
+| `command not found: drexler`                               | Add `~/.bun/bin` to `$PATH`, or restart shell                                             |
+| `command not found: bun`                                   | Install Bun (see [Install](#install) section above)                                       |
+| `API key rejected by OpenRouter`                           | Update key: `rm ~/.config/drexler/config.json` and re-run `drexler`, or export `OPENROUTER_API_KEY` |
+| Garbled box-drawing characters                             | Use a UTF-8 terminal with a Nerd Font (e.g. iTerm2, Alacritty, WezTerm)                   |
+| Want to switch themes mid-session                          | Use `/theme midnight`, `/theme dealroom`, `/theme amber`, or any listed theme inside the REPL |
+| Want a faster launch                                       | Use `drexler --fast` or set `"fast": true` in config                                     |
+
+---
+
 ## License
 
-MIT.
+MIT — see [LICENSE](./LICENSE).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drexler",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "CLI chat with Drexler, a corporate-executive AI persona built on OpenRouter Gemma 4 31B.",
   "license": "MIT",
   "author": "showOS",
@@ -30,6 +30,7 @@
     "src",
     "prompts",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "preferGlobal": true,