# Commands

Every `languid` command an owner uses. `languid --help` prints the full list, including the commands for running your own service.

## Updates

| command | what it does |
|---|---|
| `languid --version` | Show this installation's client release |
| `languid update --check` | Check the latest stable release without changing anything |
| `languid update` | Explicitly install a newer stable release and restart this install's runners |

Terminal chats show an update notice at most once daily, but never install automatically. Reopen an existing chat after updating. Set `LANGUID_NO_UPDATE_CHECK=1` to disable notices. Older installations need the installer run once to adopt versioned updates; developer Git checkouts are never overwritten. The web client updates when the service is deployed and you reload it.

## Chat

| command | what it does |
|---|---|
| `languid` | Open the agent you used last, or make your first one |
| `languid chat <agent>` | Open an agent in pi, in the folder you're in |
| `languid chat <agent> --computer <name>` | Open it with its tools running on another computer |
| `languid run <agent> <prompt>` | Run one prompt without pi and print the reply, in a new thread |
| `languid run <agent> -c <prompt>` | The same, continuing the latest thread |

`languid run` reads the prompt from stdin if you don't give one, which avoids shell quoting:

```sh
languid run scout -c <<< "and what about the tests?"
```

`languid run` has no one to ask, so it refuses `bash`, `edit` and `write` unless you add `--yes`. Anything after the agent's name in `languid chat` goes to pi. For example, `languid chat scout -c` continues the last pi session in this folder.

## Agents

| command | what it does |
|---|---|
| `languid agent create <name>` | Make an agent. `--model provider/id` picks its model |
| `languid agent list` | Your agents, their handles, models and DIDs |
| `languid agent model <agent>` | Show its model |
| `languid agent model <agent> <provider/id>` | Change its model |

## Computers

| command | what it does |
|---|---|
| `languid computer setup` | Let your agents use this computer, starting its runner now and at login |
| `languid computer list` | Your computers, and whether each is connected |
| `languid computer attach <name> --agent <a,b>` | Let agents use a computer you've already set up |
| `languid computer remove <name>` | Remove a computer and revoke its runner |
| `languid computer run` | Start this computer's runner by hand, where setup can't start it at login |

## Accounts

| command | what it does |
|---|---|
| `languid login` | Sign in this terminal |
| `languid whoami` | Who you're signed in as, and your agents |
| `languid logout` | Sign out |
| `languid account list` | Every account signed in on this computer |
| `languid account use <handle>` | Switch to another signed-in account |
| `languid --as <handle> <command>` | Run one command as another account, without switching |

## In pi

| command | what it does |
|---|---|
| `/model` | Pick the agent's model |
| `/threads` | Open any of the agent's threads, from any computer |
| `/threads new` | Start a new thread |
| `/rename` | Name this thread |
| `/compact` | Summarize the thread's older messages now |
| `/approvals` | List the rules for what runs without asking, and remove them |
| `/languid` | Show the agent, its thread and its computers |
| `/languid blocks` | Show its memory blocks |

## Updating

Run the install command again. It updates Languid and restarts this computer's runner:

```sh
curl -fsSL https://languid.ai/install | sh
```
