> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rakumux.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sign in

> Sign in to your Rakumux account from the terminal, with a code you approve in any browser.

Rakumux works fully without an account. Signing in adds
[AI session titles](https://docs.rakumux.com/account/ai-titles.md), which name your sessions, the [agent feed](https://docs.rakumux.com/account/feed.md),
new sessions and replies from rakumux.com, and [rtop](https://docs.rakumux.com/guides/rtop.md) there, all of them for any
account, Free or Pro. Accounts are by invitation for now: join the
waitlist at [rakumux.com](https://rakumux.com).

## Sign in from the terminal

Rakumux signs in with a short code that you approve in a browser, on this computer or any other, so
it works the same over SSH:

**1. Ask for a code**

In Rakumux mode press `a`, click **a Sign in** at the bottom right of the footer, or open
**Settings → Account**. From a shell, `rakumux account login` does the same.

**2. Open the link**

Rakumux shows a code, a link and its QR code. Open the link in any browser, or scan the QR code
with your phone. Over SSH, `c` in the sign-in dialog copies the link to your local clipboard (in
terminals that let programs set it).

**3. Approve**

Sign in at rakumux.com (or create your account), check that the code matches, and approve.
Rakumux picks up the sign-in by itself.

> [!WARNING]
>
> Approve only a code you started yourself, on your own machine: rakumux.com never sends you this
> link. Approving signs the terminal showing the code in to your account. It can read your chats,
> shares its agents' chats with rakumux.com, and runs the replies and new sessions you send it.

## Your account

Signed in, `a` (or **Settings → Account**) shows who you're signed in as. Everything above is on
while you're signed in; there are no switches. Sign out to stop it on that machine.

On the web, rakumux.com stays the public site; while you're signed in, its header shows **Open app**
in place of **Sign in**. Open app, and signing in, take you to your **Sessions**. In the web app's
header, the Rakumux logo goes back to Sessions, and at the top right **≡** shows or hides your feed
beside them; the other pages are under the **Settings** gear next to it:

| Page | What's there |
| - | - |
| [rakumux.com/status](https://rakumux.com/status) | **Sessions**: your [sessions](https://docs.rakumux.com/account/feed.md#your-sessions-on-the-web) on every machine, grouped by status as in Rakumux's Status tab; open one to read its chat and write back |
| [rakumux.com/feed](https://rakumux.com/feed) | Sessions with your [agent feed](https://docs.rakumux.com/account/feed.md) shown beside them: your agents' turns from every machine, newest first |
| [rakumux.com/folders](https://rakumux.com/folders), [rakumux.com/app](https://rakumux.com/app) | The same sessions grouped by machine and folder, or by app, as in the Folders and App tabs |
| [rakumux.com/install](https://rakumux.com/install) | How to install and start Rakumux (Settings) |
| [rakumux.com/account](https://rakumux.com/account) | Your email, connected accounts, security, deleting your account, a [Sprite](https://docs.rakumux.com/remote/fly-sprites.md) you connected, with Revoke, and **Sign out all terminals** (Settings) |

## From the command line

| Command | Does |
| - | - |
| `rakumux account login` | Print a link, a code and (on a terminal) a QR code, and wait for approval |
| `rakumux account status [--json]` | Who is signed in, and each live session's AI description |
| `rakumux account logout` | Sign out on this machine and revoke its sign-in; AI session titles and the feed stop there |

## What runs on your machine

Signing in starts a small background service for your account, `rakumux status-service`. Like the
server, it keeps running when you quit Rakumux, and Rakumux starts it again when needed.

* Your sign-in is stored in `~/.rakumux/sensagent/credentials/`, readable only by you, and renewed
  automatically before it expires.
* Its log is `~/.rakumux/logs/status-service.log`.
* Sign out with **Settings → Account** (`o`) or `rakumux account logout`. Signing out also revokes
  the machine's sign-in, so a copy of it can't be renewed; Rakumux says if it couldn't.

Signing out of the website in a browser doesn't sign the terminal out; use one of the above. To
sign out every machine at once, for example if one was lost, use **Sign out all terminals** on
[rakumux.com/account](https://rakumux.com/account): each machine signs out the next time it checks
in, within a few minutes while it's running. A [Sprite](https://docs.rakumux.com/remote/fly-sprites.md) you connected has its
own credential: revoke it there too.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.