carlos / platform Public

docs: carlos add names its account (#175 Q7)

The copy approved in review, verbatim: the CLI reference's example names
--account, and a paragraph says it is required and that a re-add keeps the
owner. infra/remote-host.md's example gains the flag.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Human

Prompt

Approved (copy review of the carlos add strings)

From this commit's own message. The prompt ledger has no entries for it — which is what a squashed, rebased or amended commit looks like, and what every commit looks like in a repo without a ledger.

Summary

Docs for the carlos add account requirement, as approved.

claude 3 weeks ago b78f5babc807315b6ea8b0e68c5f8db0140840c1 parent 8568764

2 files changed, +4 −2

docs/site/cli.md +3 −1
infra/remote-host.md +1 −1

CI passed — run details

Intent

full ledger: carlos-add-account

diff --git a/docs/site/cli.md b/docs/site/cli.md

index cedeb32f0..cc85663ee 100644

--- a/docs/site/cli.md

+++ b/docs/site/cli.md

@@ -1375,9 +1375,11 @@ app, following this channel. It is the box-local, operator-side counterpart

to an instance record.

```sh

-carlos add --app hello --socket /run/hello.sock hello.example.com

+carlos add --account kass --app hello --socket /run/hello.sock hello.example.com

```

+`--account` (or `--account-id`) names the account the route belongs to, and is required. Running `carlos add` again for a hostname that already has a route rewrites it but keeps its owner. An add that names a different account is refused.

`--channel` sets what the route follows, `--kind` picks instance, service or

static, and `--addr` takes a TCP upstream where the app is not a socket

tenant. `--unit console.service` names the systemd unit that owns the route's

diff --git a/infra/remote-host.md b/infra/remote-host.md

index f08826c0a..15e709eaa 100644

--- a/infra/remote-host.md

+++ b/infra/remote-host.md

@@ -66,7 +66,7 @@ refuses to boot.

`carlos route` repoints an EXISTING route — it does not create one. Add the

route first, then back it with the tunnel channel:

- carlos add <h>

+ carlos add --account <account> <h>

carlos route -host <h> -tunnel <name>

## Fleet boxes (customer fleets)