cinatra 0.1.0 → 0.1.1

package/README.md

@@ -1,18 +1,20 @@
 # cinatra
 
-The command-line tool for setting up, operating, and maintaining a [Cinatra](https://cinatra.ai) instance.
+The command-line tool for [Cinatra](https://cinatra.ai) — the open-source AI platform you host yourself.
+
+Cinatra lets you run AI agents, connect them to your own tools, data, and content, and put that to work across your apps and workflows — on infrastructure you control. This CLI is how you stand up a Cinatra instance and keep it running.
+
+## Quick start
 
 ```sh
 npx cinatra install
 ```
 
-`cinatra install` is the only command that runs **from zero** — before any Cinatra checkout exists. It checks your prerequisites first (Node 20+, git, pnpm via Corepack, Docker + Compose), clones the Cinatra repo, creates your environment, brings up the local infra, and runs setup inside the freshly cloned checkout.
-
-Every other command operates **on a Cinatra checkout** — a cloned copy of the Cinatra repository. After `install`, run them from inside that checkout (or point at one with `CINATRA_REPO_ROOT`).
+This sets up a Cinatra instance from scratch — it checks your prerequisites, fetches Cinatra, creates your environment, starts the local services, and runs first-time setup. After that, run the other commands from inside your new Cinatra directory.
 
 ## Install
 
-No global install required — run on demand with `npx`:
+Run on demand, no install needed:
 
 ```sh
 npx cinatra <command>
@@ -22,55 +24,23 @@ Or install globally:
 
 ```sh
 npm install -g cinatra
-cinatra <command>
 ```
 
-Requires **Node.js >= 20**.
-
-## The checkout-driven model
-
-This CLI is intentionally **thin**: it bundles no Cinatra application code. The heavy, version-sensitive internals it drives — the database **migration runner**, the **connector catalog**, and the **agent-skill** compiler — are resolved **from your checkout at runtime**, against the exact versions installed there. This keeps the published tool small and guarantees the runner code always matches the migrations and schema in the checkout it operates on.
+Requires Node.js >= 20.
 
-Practically, that means:
-
-- `cinatra install` works from anywhere (it creates the checkout).
-- All other commands need a checkout. They resolve it in this order:
-  1. `CINATRA_REPO_ROOT=<path-to-checkout>` if set, else
-  2. an upward search from your current directory for a Cinatra checkout.
-
-  If neither finds one, the command fails with a clear message rather than guessing.
+## What you can do
 
 ```sh
-# Run from inside a checkout:
-cd my-cinatra
-cinatra setup dev
-
-# Or point at one explicitly:
-CINATRA_REPO_ROOT=/path/to/my-cinatra cinatra db migrate
+cinatra install                # set up a new Cinatra instance from scratch
+cinatra setup dev              # provision a local development instance
+cinatra setup prod             # provision a production instance
+cinatra db migrate             # apply schema updates to an instance
+cinatra status                 # check an instance's status
+cinatra doctor                 # diagnose your local setup
+cinatra agents install <name>  # add an agent to your instance
 ```
 
-## Common commands
-
-```sh
-cinatra install [--dir <path>] [--ref <main|tag|sha>] [--mode dev|prod]
-cinatra setup dev                  # provision a local dev instance
-cinatra setup prod                 # provision a production instance
-cinatra db migrate [--down]        # apply / revert core schema migrations
-cinatra status                     # local or remote instance status
-cinatra doctor [--strict]          # diagnose the local setup
-cinatra agents install <name>      # resolve + install an agent dependency tree
-```
-
-Run `cinatra --help` for the full command list, and `cinatra <command> --help` for per-command options.
-
-```sh
-cinatra --help
-cinatra --version
-```
-
-## Versioning
-
-`cinatra --version` reports **this CLI's** own version. It is distinct from the Cinatra application version and from the `cinatra.ai/v1` API version.
+Most commands run from inside your Cinatra directory. Run `cinatra --help` for the full command list and `cinatra <command> --help` for per-command options.
 
 ## License
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cinatra",
-  "description": "The cinatra command-line tool for setting up, operating, and maintaining a Cinatra instance",
-  "version": "0.1.0",
+  "description": "Install, run, and maintain your own self-hosted Cinatra instance — the open-source AI platform — from the command line.",
+  "version": "0.1.1",
   "type": "module",
   "license": "Apache-2.0",
   "bin": {