@habemus-papadum/aiui 0.0.0-reserve.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nehal Patel
+
+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

@@ -1,3 +1,42 @@
 # @habemus-papadum/aiui
 
-Name-reservation placeholder. The real package is published from CI (`.github/workflows/release.yml`) via npm trusted publishing.
+ai ui frontends — the `aiui` CLI: launchers and browser plumbing for an
+agent-in-the-loop UI workflow. ⚠️ Read the repo's *Read before running* guide first: `aiui claude`
+skips permissions by default and gives the agent a browser.
+
+## Install
+
+```sh
+npm install @habemus-papadum/aiui
+```
+
+## CLI
+
+```sh
+aiui demo      # scaffold a disposable demo playground (safe to re-run — it continues)
+aiui claude    # launch Claude Code wired with the aiui channel, plugin, and browser MCP
+aiui vite      # launch Vite against the running channel (sets VITE_AIUI_PORT)
+aiui browser   # start (or find) the shared session browser; --tunnel <host> = remote-dev local half
+aiui open <url># open a URL as a tab in the session browser
+aiui chrome    # manage the browser: install | update | status | extension
+aiui mcp       # forward to the aiui-claude-channel CLI (e.g. `aiui mcp quick`)
+aiui --help
+```
+
+Flags for `aiui claude` beginning with `--aiui-` are consumed by aiui (`--aiui-no-chrome`,
+`--aiui-chrome-profile <name>`, `--aiui-tag <tag>`, …); everything else forwards to `claude`
+verbatim. `--help`/`--version` are inert: aiui prints its own answer, then the wrapped tool's
+follows — no config, browser, or Chrome-for-Testing activity. Durable settings live in
+`config.json` (user cache + project `.aiui-cache/`) — see the repo's *Configuration* guide.
+
+Built with [commander](https://github.com/tj/commander.js) for the command tree and
+[execa](https://github.com/sindresorhus/execa) to spawn the child processes. The command
+implementations live in `src/commands/`.
+
+During development, run the CLI straight from source (via `tsx`, no build) with the
+`./aiui` launcher at the repo root:
+
+```sh
+./aiui claude
+./aiui --help
+```

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export {};