acbridge 0.0.1 → 1.0.1

package/LICENSE

@@ -0,0 +1,40 @@
+AC BRIDGE — END USER LICENCE
+
+Copyright (c) 2026 AC BRIDGE LIMITED (registered in England and Wales,
+company number 17356395). All rights reserved.
+
+This software is proprietary. It is not open source, and no rights are granted
+except those set out below and in the terms published at
+https://ac-bridge.com/terms.
+
+WHAT YOU MAY DO
+
+Subject to an active AC Bridge subscription (including its free trial period),
+you may install and use this software on machines you own or control, for your
+own purposes, personal or commercial.
+
+WHAT YOU MAY NOT DO
+
+You may not redistribute, sublicense, sell, rent or host this software for
+others; remove or alter this notice; or reverse engineer, decompile or
+disassemble it, except to the extent that restriction is unenforceable under
+the law that applies to you.
+
+IF YOUR SUBSCRIPTION ENDS
+
+Your right to use the software ends with it. Nothing here obliges you to delete
+anything the software wrote on your own machines: your configuration, logs and
+credentials are yours.
+
+NO WARRANTY
+
+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. TO THE FULLEST EXTENT
+PERMITTED BY LAW, AC BRIDGE LIMITED SHALL NOT BE LIABLE FOR ANY CLAIM, DAMAGES
+OR OTHER LIABILITY ARISING FROM OR IN CONNECTION WITH THE SOFTWARE OR ITS USE.
+
+Nothing in this licence limits any rights you have as a consumer that cannot be
+limited by agreement.
+
+Questions: support@ac-bridge.com

package/README.md

@@ -1,6 +1,82 @@
 # acbridge
 
-This package name is reserved for **AC Bridge** — the Alexa ↔ Claude Code voice bridge — at
-[ac-bridge.com](https://ac-bridge.com). The `acbridge` command line will be published here.
+<img src="https://www.ac-bridge.com/brand/ac-bridge-mark-gradient.png" width="96" alt="AC Bridge">
 
-Until then, download AC Bridge from [ac-bridge.com](https://ac-bridge.com).
+**Quiet status lights for Claude Code and Codex.**
+
+Control **AC Bridge** from any terminal: sign in, run the bridge, and drive your smart-home devices
+and Profiles — the scenes that react to what your coding agent is doing.
+
+It is the full terminal peer of the [AC Bridge](https://ac-bridge.com) desktop app. Everything below
+runs headlessly on a box with no GUI; sign-in wants a browser once (see the SSH note below).
+
+```sh
+npm i -g acbridge
+```
+
+## Before you start
+
+- **Node.js 22 or newer.**
+- **An AC Bridge subscription** — sign up (3-day free trial) at <https://ac-bridge.com>.
+- **[Claude Code](https://claude.com/claude-code) or the OpenAI Codex CLI**, if you want Profiles to
+  react to your sessions. Device control works without either.
+
+## Get going
+
+```sh
+acbridge login     # sign in this machine (opens your browser)
+acbridge setup     # once per machine: installs the agent hooks that feed Profiles
+acbridge start     # bring the bridge up in the background
+```
+
+Then launch `claude` (or `codex`) in any project and your Profiles react to it. `acbridge stop` puts
+every device it touched back the way it found it.
+
+No browser on the box? `acbridge login --no-browser` prints a sign-in URL served on this machine's
+loopback — open it in a browser **on the same machine**, or over SSH forward the port first
+(`ssh -L 8765:127.0.0.1:8765 <box>`) and open it on your laptop. The command keeps waiting either way.
+
+## What else it does
+
+| | |
+|---|---|
+| `acbridge status` | is the bridge up, who is signed in, what is running |
+| `acbridge doctor` | checks every requirement and prints the fix for each one |
+| `acbridge scan` | find smart-home devices on your LAN |
+| `acbridge connect` / `link` | add a device or link a provider account (Hue, Home Assistant, SmartThings, Tuya, and more) |
+| `acbridge devices` | list devices and control them — on/off, brightness, colour, scenes |
+| `acbridge profiles` | see the Profiles bound to each project |
+| `acbridge stop` | stop the bridge and revert every device it changed |
+
+Run `acbridge --help`, or `acbridge <command> --help`, for the full list and every flag.
+
+## Good to know
+
+- **Your credentials stay on your machine.** Device and provider secrets are written to your OS
+  keychain where one is available, and to `0600` files otherwise — they never leave the machine.
+  `acbridge logout` removes them.
+- **The bridge only runs while something is holding it.** Closing the app or running `acbridge stop`
+  releases it; nothing lingers in the background that you did not ask for.
+- **Windows, macOS and Linux**, including WSL2.
+
+## Uninstalling
+
+```sh
+acbridge uninstall     # unwires the agent hooks, plugin, and firewall rule; asks about your account data
+npm uninstall -g acbridge
+```
+
+Add `--purge` to the first command to delete **everything** AC Bridge stored on this machine —
+sign-out included — so a future install starts completely fresh.
+
+## Help
+
+- `acbridge doctor` — most problems name their own fix.
+- Docs, downloads and account: <https://ac-bridge.com>
+- <support@ac-bridge.com>
+
+---
+
+(c) 2026 AC BRIDGE LIMITED. All rights reserved. Use of this software is governed by the terms at
+<https://ac-bridge.com/terms>. Works with Claude Code and Codex. Not affiliated with or endorsed by
+Anthropic or OpenAI.