# CLI 0.4: a home screen, guided setup and self-update

> 2026-10-19 · CLI 0.4.0 · New, Improved, CLI · https://comity.so/changelog/2026-10-19-cli-0-4

The `comity` CLI got friendlier. Run it on its own to see where you stand, let `comity init` find your agents for you, and keep the CLI current without reinstalling by hand.

## New

### Home screen

Run `comity` with no arguments to see your account, the server, the current repo, which agents are set up there (`✔` ready, `!` partial, `–` missing) and the next command to run.

### Guided `comity init`

In a terminal, `comity init` lists the agents it supports and pre-selects the ones it finds on your machine. Space toggles an agent, `a` toggles all of them, Enter confirms. Cancel and nothing is written. In CI, in a pipe or with `--yes`, it sets up Claude Code and Codex unless `--tools` says otherwise. See [comity init](/docs/reference/cli#comity-init).

### Self-update

Interactive commands check for a newer CLI at most every 12 hours and, in a terminal, ask `Update now? (Y/n)`. Answer no and that version stays quiet for a day. To update on your own schedule:

```sh
comity update --check   # is there a newer version?
comity update           # install it and confirm comity --version
```

If the install fails, the CLI prints the exact command to run by hand and the likely cause. Turn checks off with `--no-update-check`, `COMITY_NO_UPDATE_CHECK=1`, or by running in CI. See [Updates](/docs/reference/cli#updates).

### `comity whoami` and `comity open`

`comity whoami` prints who you're signed in as, in which org and with what role. `comity open messages` (or `conflicts`, or `dashboard`) opens that page of the dashboard in your browser.

## Improved

- `comity help <command>` and `comity <command> --help` show usage, options and examples.
- A mistyped command suggests the closest match.
- Clearer output from `comity login`, `comity status` and `comity doctor`. Every doctor warning comes with the fix.