@hireobi/cli 0.0.0-stage → 0.1.7

package/LICENSE

@@ -0,0 +1,20 @@
+Heysurface CLI License
+
+Copyright (c) 2026 Heysurface, Inc. All rights reserved.
+
+Heysurface, Inc. grants you a non-exclusive, non-transferable license to install,
+copy, and use the Heysurface CLI package, including its bundled Skill, for your
+own internal use with an authorized Heysurface account. You may adapt the Skill
+for that internal use. You may not redistribute, sublicense, sell, or offer the
+package or an adapted version to others without Heysurface, Inc.'s written
+permission.
+
+This license does not grant access to the Heysurface service or to any paid
+capability. Service access and use are governed by the applicable Heysurface
+terms. Third-party components retain their own licenses and notices.
+
+THE PACKAGE IS PROVIDED "AS IS", WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+PURPOSE, AND NON-INFRINGEMENT. TO THE MAXIMUM EXTENT PERMITTED BY LAW,
+HEYSURFACE, INC. IS NOT LIABLE FOR CLAIMS, DAMAGES, OR OTHER LIABILITY ARISING
+FROM THE PACKAGE OR ITS USE.

package/README.md

@@ -1,3 +1,32 @@
-# Temporary Holding Version
+# Obi CLI
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The CLI connects an invited account to Obi, the AI Search Employee by Heysurface, Inc., in the customer's own assistant. The bundled Skill does the work in the chat: public business research saved through a versioned work boundary, buyer questions, and server-measured engine answers kept apart from host reasoning. Publishing the package does not enable public signup or grant an uninvited account access.
+
+## Install
+
+Node.js 22 or later is required:
+
+```bash
+npm install --global @hireobi/cli
+obi --version
+obi skill install
+```
+
+`obi skill install` registers exactly two personal Skill links, one for each supported local directory, and refuses a conflicting file or broken link, leaving the other Skill intact. `obi skill path` locates the bundled Skill. `obi skill install` also removes the `/heysurface` Skill links an earlier alpha registered from this same package, so an assistant lists one Skill; a `/heysurface` entry of any other kind is left untouched. A cloud harness needs its own supported installation path.
+
+## Use
+
+Open a new assistant chat. In [Claude Code](https://code.claude.com/docs/en/skills) or [Cursor](https://cursor.com/docs/skills), type `/obi`. In Codex CLI, type `$obi` or select Obi through `/skills`; in the desktop app, use the [skills picker](https://learn.chatgpt.com/docs/build-skills). The Skill asks which website to work on and follows the conversation language.
+
+Running bare `obi` in an interactive terminal shows the Obi mascot and a short welcome, then exits: the conversation happens in the assistant. The greeting is English or French; `OBI_LANGUAGE` overrides `LC_ALL`, `LC_MESSAGES`, then `LANG`.
+
+Run `obi --help` for the complete command grammar and the starting steps. `--json` returns one validated envelope per invocation. After a timeout or a conflict, read the current state before retrying a write; a submission may be resent with the same file and replay key. Credentials stay in the system credential store or an explicitly selected owner-only file, and the CLI never prints tokens. The Skill's references carry the result contracts, such as [host work](skills/heysurface/references/host-work.md) and [outcomes](skills/heysurface/references/outcomes.md).
+
+An authorized operator can start an isolated public-company evaluation case with `obi eval start <domain> --json`, then add its `--eval-case <id>` to every later status, business, harness, readiness, questions or strategies command, `harness artifact` save, show, history and export included. An evaluation does not prove ownership of that company's website.
+
+## Repository development
+
+```bash
+npm --workspace @hireobi/cli run build
+node cli/dist/obi.js --help
+```