konjir 0.5.0 → 0.7.0

package/README.md

@@ -13,12 +13,12 @@ Or install it with `npm install -g konjir@<version>`. Always name the exact vers
 Sign in with your browser, where Kolab asks you who the CLI works as (an agent of yours, by default), in which kolab and role:
 
 ```
-konjir login --url https://kolab.example.com/mcp [--kolab <name>] [--role product|engineer]
+konjir login --url https://kolab.example.com/mcp [--kolab <name>] [--role product|engineer] [--agent <agent>]
 konjir whoami
 konjir logout                # revokes the sign-in
 ```
 
-The sign-in is kept in `~/.config/konjir/credentials.json`, readable by you alone, and renews itself; every command uses it while `KONJIR_TOKEN` is unset.
+The sign-in is kept in `~/.config/konjir/credentials.json`, readable by you alone, and renews itself; every command for that URL uses it while `KONJIR_TOKEN` is unset or empty. With no `KONJIR_URL` or `--url`, konjir uses the one sign-in it keeps, when it keeps exactly one.
 
 Or point it at a Kolab server with a session token:
 
@@ -26,13 +26,24 @@ Or point it at a Kolab server with a session token:
 export KONJIR_URL=https://kolab.example.com/mcp KONJIR_TOKEN=<your session token>
 konjir whoami
 konjir instructions          # the operating rules and precedent: read this first
-konjir tools                 # every verb, one line each
+konjir tools                 # every verb with its parameters
 konjir watch --once          # wait for the next change to your inbox
 ```
 
 `--url` and `--token` work too. The token decides who you are and which layer you may write.
 
-This package is the client only. Kolab itself, and `konjir serve`, run from a checkout of [github.com/konjir/kolab](https://github.com/konjir/kolab).
+## Claude Code
+
+One command connects Claude Code to a kolab, with one agent per entry, each signed in on one page in your browser:
+
+```
+konjir connect claude --kolab <name> [--agent <label>[:<role>]]… [--subagents]
+konjir claude <label>        # one agent's session, as connect prints last
+```
+
+Each entry is the Konjir channel, which this package carries as `konjir bridge`: Kolab's tools, and your inbox pushed into the session as it changes. Claude Code starts it; you never run it by hand. `--subagents` also writes `.claude/agents/<label>.md` for each agent, limited to that agent's Konjir tools. With no `--url`, `konjir connect` sets up at `https://kolab.konjir.com/mcp`.
+
+This package is the client and the channel. Kolab itself, and `konjir serve`, run from a checkout of [github.com/konjir/kolab](https://github.com/konjir/kolab).
 
 ## Licence