lacy 1.8.17 → 1.8.20

package/README.md

@@ -1,231 +1,61 @@
-<p align="center">
-  <a href="https://lacy.sh">
-    <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lacymorrow/lacy/HEAD/.github/assets/logo-horizontal-dark.svg">
-      <img src="https://raw.githubusercontent.com/lacymorrow/lacy/HEAD/.github/assets/logo-horizontal.svg" alt="Lacy" width="220">
-    </picture>
-  </a>
-</p>
+# lacy
 
-<p align="center"><strong>Talk to your shell.</strong> Commands run. Questions go to AI. No prefixes. No context switching. You just type.</p>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/lacy"><img alt="npm version" src="https://img.shields.io/npm/v/lacy?style=flat"></a>
-  <a href="https://www.npmjs.com/package/lacy"><img alt="npm downloads" src="https://img.shields.io/npm/dm/lacy?style=flat"></a>
-  <a href="https://github.com/lacymorrow/lacy/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/lacymorrow/lacy/ci.yml?style=flat&label=CI"></a>
-  <a href="https://github.com/lacymorrow/lacy/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/lacymorrow/lacy?style=flat"></a>
-  <a href="https://fsl.software"><img alt="License: FSL-1.1-MIT" src="https://img.shields.io/badge/License-FSL--1.1--MIT-blue?style=flat"></a>
-</p>
-
-<p align="center">
-  <img src="https://raw.githubusercontent.com/lacymorrow/lacy/HEAD/docs/demo-full.gif" alt="Lacy Shell demo — commands run in shell, questions go to AI" width="680" />
-</p>
-
-## Why Lacy?
-
-- **No new tools to learn** — Lacy works with your existing AI CLI (Claude Code, Gemini, OpenCode, Codex, Lash). It's a complement, not a replacement.
-- **Zero friction** — No slash commands, no hotkeys, no separate terminal. Type naturally and Lacy routes it. A real-time color indicator shows you what will happen before you press enter.
-- **Smart detection** — Lacy classifies input using word analysis, not AI. It's instant. Commands like `ls -la` stay green (shell). Questions like `what files are here` turn magenta (AI). If a command fails with natural language patterns, it silently reroutes to AI.
-
-> *Works with ZSH and Bash 4+ on macOS, Linux, and WSL.*
+Interactive installer for [Lacy Shell](https://github.com/lacymorrow/lacy) — talk directly to your shell.
 
 ## Install
 
-> Supported installation methods: `npm`, `curl`, `homebrew`, `git`
-
-#### Install using `npx`
-
 ```bash
 npx lacy
 ```
 
-#### Install using `curl`
+Features:
+- Arrow-key tool selection
+- Auto-detects installed AI CLI tools
+- Offers to install lash if selected
+- Automatic shell restart
 
-```bash
-curl -fsSL https://lacy.sh/install | bash
-```
-
-<details>
-<summary>Other methods</summary>
+## Uninstall
 
 ```bash
-# Homebrew
-brew tap lacymorrow/tap
-brew install lacy
-
-# Manual
-git clone https://github.com/lacymorrow/lacy.git ~/.lacy
-echo 'source ~/.lacy/lacy.plugin.zsh' >> ~/.zshrc
+npx lacy --uninstall
 ```
 
-</details>
+## Options
 
-## How It Works
-
-Real-time visual feedback shows what will happen before you hit enter:
-
-<p align="center">
-  <img src="https://raw.githubusercontent.com/lacymorrow/lacy/HEAD/docs/demo-indicator.gif" alt="Green indicator for shell commands, magenta for AI" width="680" />
-</p>
-
-Commands execute in your shell. Natural language goes to your AI agent. No prefixes, no context switching — you just type.
-
-| Input                          | Routes to  | Why                                         |
-| ------------------------------ | ---------- | ------------------------------------------- |
-| `ls -la`                       | Shell      | Valid command                               |
-| `what files are here`          | AI         | Natural language                            |
-| `git status`                   | Shell      | Valid command                               |
-| `do we have a way to install?` | AI         | Reserved word — never a real command        |
-| `fix the bug`                  | AI         | Multi-word, not a command                   |
-| `kill the process on 3000`     | Shell → AI | Valid command, but fails — rerouted         |
-| `go ahead and fix it`          | Shell → AI | "go" is valid, but "ahead" triggers reroute |
-| `!rm -rf *`                    | Shell      | `!` prefix forces shell                     |
-
-The first word of your input is also syntax-highlighted in real-time: **green** for shell commands, **magenta** for AI queries.
-
-**Smart rerouting** (auto mode): When a valid command contains natural language patterns (3+ bare words with articles, pronouns, etc.) and fails, lacy shows a hint and automatically re-sends it to the AI agent. Shell reserved words like `do`, `then`, `in`, `else` are routed directly to the agent — they pass `command -v` but are never standalone commands.
-
-**Terminal context**: When you ask the AI a question, lacy automatically includes your current directory, git branch, recent commands, and exit codes, but only what changed since your last query. In supported terminals (tmux, screen, iTerm2, Terminal.app), it also captures the visible screen output so the agent can see error messages and stack traces.
-
-## Modes
-
-<p align="center">
-  <img src="https://raw.githubusercontent.com/lacymorrow/lacy/HEAD/assets/mode-indicators.jpeg" alt="Shell and Agent mode indicators" width="480" />
-</p>
-
-| Mode      | Behavior                | Activate                     |
-| --------- | ----------------------- | ---------------------------- |
-| **Auto**  | Smart routing (default) | `mode auto`                  |
-| **Shell** | Everything to shell     | `mode shell` or `Ctrl+Space` |
-| **Agent** | Everything to AI        | `mode agent` or `Ctrl+Space` |
-
-## Supported Tools
-
-Lacy auto-detects your installed AI CLI. All tools handle their own auth — no API keys needed.
-
-<p align="center">
-  <img src="https://raw.githubusercontent.com/lacymorrow/lacy/HEAD/assets/supported-tools.jpeg" alt="Supported AI CLI tools" width="680" />
-</p>
-
-```bash
-tool set claude    # Use Claude Code
-tool set lash      # Use Lash
-tool set auto      # Auto-detect (first available)
 ```
+Usage:
+  npx lacy              Install Lacy Shell
+  npx lacy --uninstall  Uninstall Lacy Shell
 
-Or edit `~/.lacy/config.yaml`:
-
-```yaml
-agent_tools:
-  active: claude # lash, claude, opencode, gemini, codex, custom, or empty for auto
+Options:
+  -h, --help       Show help message
+  -u, --uninstall  Uninstall Lacy Shell
 ```
 
-## Commands
-
-| Command                     | Description          |
-| --------------------------- | -------------------- |
-| `mode`                      | Show current mode    |
-| `mode [shell\|agent\|auto]` | Switch mode          |
-| `tool`                      | Show active AI tool  |
-| `tool set <name>`           | Set AI tool          |
-| `ask "query"`               | Direct query to AI   |
-| `Ctrl+Space`                | Toggle between modes |
+## What is Lacy Shell?
 
-## CLI
+Lacy routes natural language to AI and commands to your shell — automatically.
 
-After installation, the `lacy` command is available (no Node required):
-
-```bash
-lacy setup        # Interactive settings (tool, mode, config)
-lacy status       # Show installation status
-lacy doctor       # Diagnose common issues
-lacy update       # Pull latest changes
-lacy config edit  # Open config in $EDITOR
-lacy uninstall    # Remove Lacy Shell
-lacy help         # Show all commands
 ```
-
-## Uninstall
-
-```bash
-lacy uninstall
-# or
-npx lacy --uninstall
-# or
-curl -fsSL https://lacy.sh/install | bash -s -- --uninstall
+❯ ls -la                → runs in shell
+❯ what files are here   → AI answers
+❯ git status            → runs in shell
+❯ fix the build error   → AI answers
 ```
 
-## Configuration
-
-Config file: `~/.lacy/config.yaml`
-
-```yaml
-agent_tools:
-  active: claude # lash, claude, opencode, gemini, codex, or empty for auto
-
-modes:
-  default: auto # shell, agent, auto
-
-api_keys:
-  openai: "sk-..." # Only needed if no CLI tool installed
-  anthropic: "sk-ant-..."
-```
-
-## Troubleshooting
-
-**No AI response** — Check `tool` to see if a tool is detected. Install one: `npm i -g lashcode` or `brew install claude`.
-
-**Colors not showing** — Ensure your terminal supports 256 colors (green=34, magenta=200, blue=75).
-
-**Command rerouted unexpectedly** — In auto mode, commands with natural language patterns that fail are re-sent to the AI. Switch to `mode shell` to disable this, or prefix with `!`.
-
-**Emergency bypass** — Prefix any command with `!` to force shell execution: `!rm -rf node_modules`
+Works with: **lash**, **claude**, **opencode**, **gemini**, **codex**
 
-## Releasing
-
-Requires [Bun](https://bun.sh), [gh](https://cli.github.com), and `npm login`.
+## Alternative Install Methods
 
 ```bash
-bun run release          # interactive — prompts for patch/minor/major
-bun run release patch    # patch bump  (1.5.3 → 1.5.4)
-bun run release minor    # minor bump  (1.5.3 → 1.6.0)
-bun run release major    # major bump  (1.5.3 → 2.0.0)
-bun run release 2.0.0    # explicit version
-```
-
-The script handles the full release flow:
-
-1. Bumps version in both `package.json` files
-2. Commits with `release: v<version>` and tags
-3. Pushes to GitHub and creates a GitHub release
-4. Publishes the npm package (prompts for OTP if required)
-
-## Support This Project
-
-Lacy Shell is free and open source. If it saves you time, consider sponsoring the project:
-
-[![Sponsor](https://img.shields.io/badge/Sponsor-❤-ea4aaa?style=for-the-badge&logo=github)](https://github.com/sponsors/lacymorrow)
-
-Your support keeps development active and helps cover infrastructure costs.
-
-## Contributors Welcome
-
-Lacy is open source and contributions are welcome! Whether you're fixing a typo, adding a feature, or improving docs, we'd love your help.
-
-- **[Good First Issues](https://github.com/lacymorrow/lacy/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)** -- great starting points for new contributors
-- **[Contributing Guide](CONTRIBUTING.md)** -- dev setup, code style, and PR process
-- **[Discussions](https://github.com/lacymorrow/lacy/discussions)** -- questions, ideas, and general chat
-
-## Star History
+# curl
+curl -fsSL https://lacy.sh/install | bash
 
-<a href="https://star-history.com/#lacymorrow/lacy&Date">
- <picture>
-   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=lacymorrow/lacy&type=Date&theme=dark" />
-   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=lacymorrow/lacy&type=Date" />
-   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=lacymorrow/lacy&type=Date" />
- </picture>
-</a>
+# Homebrew
+brew tap lacymorrow/tap
+brew install lacy
+```
 
 ## License
 
-[FSL-1.1-MIT](LICENSE) — Functional Source License v1.1 with MIT Future License (converts to MIT after 2 years). See [fsl.software](https://fsl.software) for the full text.
+MIT

package/package.json

@@ -1,57 +1,42 @@
 {
   "name": "lacy",
-  "version": "1.8.17",
-  "description": "Talk to your terminal — AI agent routing for your shell",
-  "main": "lacy.plugin.zsh",
+  "version": "1.8.20",
+  "description": "Install lacy — talk to your terminal",
+  "type": "module",
+  "bin": {
+    "lacy": "index.mjs"
+  },
+  "files": [
+    "index.mjs"
+  ],
   "scripts": {
-    "install": "./install.sh",
-    "release": "bun run script/release.ts",
-    "release:beta": "bun run script/release.ts --beta"
+    "start": "node index.mjs",
+    "release": "npm publish",
+    "release:beta": "npm version prerelease --preid=beta && npm publish --tag beta"
   },
   "keywords": [
+    "lacy",
     "shell",
     "terminal",
-    "zsh",
-    "bash",
-    "shell-plugin",
-    "cli",
     "ai",
+    "cli",
+    "developer-tools",
     "ai-agent",
-    "ai-shell",
-    "mcp",
-    "natural-language",
-    "claude",
-    "gemini",
-    "opencode",
-    "codex",
-    "developer-tools"
+    "natural-language"
   ],
-  "author": "Lacy Shell Team",
-  "license": "FSL-1.1-MIT",
-  "dependencies": {},
-  "devDependencies": {
-    "@clack/prompts": "^1.0.0",
-    "picocolors": "^1.0.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
+  "author": "Lacy Morrow",
+  "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/lacymorrow/lacy.git"
-  },
-  "bugs": {
-    "url": "https://github.com/lacymorrow/lacy/issues"
+    "url": "git+https://github.com/lacymorrow/lacy.git",
+    "directory": "packages/lacy"
   },
   "homepage": "https://lacy.sh",
-  "funding": [
-    {
-      "type": "github",
-      "url": "https://github.com/sponsors/lacymorrow"
-    },
-    {
-      "type": "individual",
-      "url": "https://www.buymeacoffee.com/lm"
-    }
-  ]
+  "dependencies": {
+    "@clack/prompts": "^0.7.0",
+    "picocolors": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
 }

package/.claude/settings.local.json

@@ -1,26 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "mcp__obs__get_obs_status",
-      "mcp__obs__list_tool_groups",
-      "mcp__obs__list_scenes",
-      "WebSearch",
-      "WebFetch(domain:syntax.fm)",
-      "WebFetch(domain:www.mux.com)",
-      "Bash(lsof:*)",
-      "Bash(/opt/homebrew/bin/bash:*)",
-      "Bash(npx next build:*)",
-      "WebFetch(domain:github.com)",
-      "WebFetch(domain:opencode.ai)",
-      "WebFetch(domain:deepwiki.com)",
-      "WebFetch(domain:opencodeguide.com)",
-      "WebFetch(domain:developers.openai.com)",
-      "WebFetch(domain:geminicli.com)"
-    ]
-  },
-  "enabledMcpjsonServers": [
-    "obs",
-    "dns-analytics"
-  ],
-  "enableAllProjectMcpServers": true
-}

package/.github/FUNDING.yml

@@ -1,3 +0,0 @@
-github: [lacymorrow]
-patreon: lacymorrow
-custom: ["https://buymeacoffee.com/lm", "https://lacymorrow.com/donate"]

package/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,49 +0,0 @@
-name: Bug Report
-description: Something isn't working as expected
-labels: ["bug"]
-body:
-  - type: input
-    id: shell
-    attributes:
-      label: Shell
-      description: Which shell are you using?
-      placeholder: "zsh 5.9 / bash 5.2"
-    validations:
-      required: true
-  - type: input
-    id: os
-    attributes:
-      label: OS
-      placeholder: "macOS 15.1 / Ubuntu 24.04 / WSL2"
-    validations:
-      required: true
-  - type: input
-    id: ai-tool
-    attributes:
-      label: AI tool
-      description: Which AI CLI are you using with Lacy?
-      placeholder: "claude / lash / opencode / gemini / codex / none yet"
-  - type: input
-    id: version
-    attributes:
-      label: Lacy version
-      description: "Run `lacy version` to check"
-      placeholder: "1.8.11"
-  - type: textarea
-    id: what-happened
-    attributes:
-      label: What happened?
-      description: What did you type and what went wrong?
-    validations:
-      required: true
-  - type: textarea
-    id: expected
-    attributes:
-      label: Expected behavior
-      description: What should have happened?
-  - type: textarea
-    id: doctor
-    attributes:
-      label: "lacy doctor output"
-      description: "Paste the output of `lacy doctor` if relevant"
-      render: shell

package/.github/ISSUE_TEMPLATE/config.yml

@@ -1,5 +0,0 @@
-blank_issues_enabled: true
-contact_links:
-  - name: Questions & Discussion
-    url: https://github.com/lacymorrow/lacy/discussions
-    about: Ask questions and share your setup in Discussions

package/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -1,28 +0,0 @@
-name: Feature Request
-description: Suggest an improvement or new feature
-labels: ["enhancement"]
-body:
-  - type: textarea
-    id: description
-    attributes:
-      label: What would you like?
-      description: Describe the feature or improvement
-    validations:
-      required: true
-  - type: textarea
-    id: use-case
-    attributes:
-      label: Use case
-      description: When would you use this? What problem does it solve?
-  - type: dropdown
-    id: area
-    attributes:
-      label: Area
-      options:
-        - Detection (how Lacy classifies input)
-        - Indicator (visual feedback)
-        - Tool integration (Claude, Gemini, etc.)
-        - Installation / setup
-        - Configuration
-        - Shell compatibility
-        - Other

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,17 +0,0 @@
-<!-- Thanks for the PR! Quick checklist below. -->
-
-## Summary
-
-<!-- What does this change, and why? -->
-
-## How to test
-
-```bash
-npm test
-```
-
-## Checklist
-
-- [ ] `npm test` passes locally
-- [ ] Updated the README if a public option changed
-- [ ] PR is focused (one logical change)

package/.github/SECURITY.md

@@ -1,32 +0,0 @@
-# Security Policy
-
-## Reporting a vulnerability
-
-Lacy intercepts every command you type and routes it either to the shell or to an AI backend. The security-relevant surfaces are:
-
-- Command classification / routing logic (does a destructive command stay shell-side as intended?)
-- Backend command construction (no shell injection when forwarding to `claude`, `gemini`, `opencode`, `codex`, `lash`)
-- Credential leakage in fallback paths or panic logs
-
-If you've found a security issue, please report it privately:
-
-➔ https://github.com/lacymorrow/lacy/security/advisories/new
-
-Or email **lacy@lacymorrow.com** with `[lacy security]` in the subject line.
-
-Expect an acknowledgement within 72 hours.
-
-## Supported versions
-
-Only the latest published version on npm / Homebrew / install.sh receives security updates.
-
-## Scope
-
-In scope:
-- The `lacy` zsh/bash/fish plugins
-- `install.sh` / `uninstall.sh`
-- The Node CLI shim (`lib/`)
-
-Out of scope:
-- Vulnerabilities in upstream AI CLIs (`claude`, `gemini`, `opencode`, `codex`, `lash`) — report to those repos
-- Issues that require an attacker who already has shell access on your machine

package/.github/assets/logo-horizontal-dark.svg

@@ -1,17 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 480 200" fill="none">
-  <title>lacy</title>
-  <g transform="translate(20, 20)">
-    <rect x="0" y="0" width="160" height="160" rx="34" fill="#10b981"/>
-    <path d="M45 50 L75 80 L45 110" stroke="#ffffff" stroke-width="14" stroke-linecap="round" stroke-linejoin="round" fill="none"/>
-    <rect x="82" y="104" width="44" height="10" rx="3" fill="#ffffff"/>
-  </g>
-  <text
-    x="210"
-    y="132"
-    font-family="ui-sans-serif, system-ui, -apple-system, 'Inter', 'Segoe UI', Roboto, sans-serif"
-    font-size="120"
-    font-weight="800"
-    letter-spacing="-6"
-    fill="#fafafa"
-  >lacy</text>
-</svg>

package/.github/assets/logo-horizontal.svg

@@ -1,17 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 480 200" fill="none">
-  <title>lacy</title>
-  <g transform="translate(20, 20)">
-    <rect x="0" y="0" width="160" height="160" rx="34" fill="#10b981"/>
-    <path d="M45 50 L75 80 L45 110" stroke="#ffffff" stroke-width="14" stroke-linecap="round" stroke-linejoin="round" fill="none"/>
-    <rect x="82" y="104" width="44" height="10" rx="3" fill="#ffffff"/>
-  </g>
-  <text
-    x="210"
-    y="132"
-    font-family="ui-sans-serif, system-ui, -apple-system, 'Inter', 'Segoe UI', Roboto, sans-serif"
-    font-size="120"
-    font-weight="800"
-    letter-spacing="-6"
-    fill="#1a0b1f"
-  >lacy</text>
-</svg>

package/.github/assets/logo.svg

@@ -1,12 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="none">
-  <title>lacy</title>
-  <!-- Rounded square — terminal emerald -->
-  <rect x="16" y="16" width="224" height="224" rx="48" fill="#10b981"/>
-  <!-- Shell prompt: `>_` glyph -->
-  <g fill="#ffffff">
-    <!-- Chevron > -->
-    <path d="M70 80 L110 128 L70 176" stroke="#ffffff" stroke-width="20" stroke-linecap="round" stroke-linejoin="round" fill="none"/>
-    <!-- Underscore cursor -->
-    <rect x="124" y="166" width="68" height="14" rx="4"/>
-  </g>
-</svg>