# Troubleshooting and limits

> What to do when a step fails, by symptom, and what the closed beta does not do, stated as facts.

Validated against app `ae3b0ef2` and Collector `0.9.0` (`54621da`), 11 November 2026.

Find your symptom in the first column. When nothing matches, write to the person who invited you, with the output of
`humanload status` and `humanload doctor`: both hold states, dates and numbers, no text and no path.

## Signing in

| What you see | Cause | What to do |
|---|---|---|
| No code arrives after you enter your address | The address is not the invited one, or the e-mail is in your spam folder. | Check spam, then tell the person who invited you which address you used. |
| A refusal page after the code | The address passed the sign-in and is not on the beta list. | Same as above. |
| The app asks you to sign in again after a day | The sign-in lasts 24 hours. | Enter your address and the new code. |
| **Confirm it is you** asks for an 8-digit code | Downloading or erasing your data needs a sign-in from the last 15 minutes. | Choose **Send the code** and type the code you receive. |

## Your profile

| What you see | Cause | What to do |
|---|---|---|
| The app refuses to save the full form | You did not choose who reads the profile. | Choose one of the three values, then save. |
| A teammate's agent receives `{"status":"none"}` for you | Your profile is private, not saved, or the teammate's agent may not read the Team you share. | Check who reads it on your profile page; ask your teammate to connect again and tick the Team. |
| An agent names the wrong colleague | Two people match the name. | The agent is told to ask you which one; give the full name. |
| `put_my_profile` answers `invalid` | A field holds a value the format does not accept. The answer does not say which one. | The answer lists every field and its allowed values: let the agent correct the file and show you the change. [Profile fields](/reference/profile-fields.md) lists them too. |

## Your agent

[Connect your agent](/connect.md#errors) explains each status: `401`, `403`, `404` and `429`.

| What you see | Cause | What to do |
|---|---|---|
| "This page expired, was already used or was opened in another browser." | The consent page was opened twice or too late. | Start the connection again from your agent. |
| "This app could not be verified: its description cannot be read." | The service could not read the client's published description. | Try again later; if it stays, the client is not one this server accepts. |
| The agent does not look a colleague up | Nothing forces an agent to follow the server's instructions. | Ask it directly: "Read how Maya wants to be asked before you write to her." |
| The agent asks to sign in again after 30 days | A connection lasts 30 days at most. | Approve it again. |

## The Collector

[Install the Collector](/install-the-collector.md#common-failures) lists the failures of install and pairing.

| What you see | Cause | What to do |
|---|---|---|
| `Hook: never observed; check hook approval` stays in `humanload status` | Claude Code has not run the hook since setup. | Quit and reopen your Claude Code sessions, then send a message. |
| `Pending days` grows in `humanload status` | Sending fails or waits. | Run `humanload doctor` and read the step it names. |
| `Connection: expired — humanload login` | The Device key reached its end date. | Run `humanload login`. |
| A day shows as unknown in the app | No complete Count reached the service for that day. | Leave the Mac online for an hour; a day never shows 0 for lack of news. |
| The Evening note dialog appears and you do not want it | This build has no setting for it. | Choose **Cancel** to close it for the day; see [Install the Collector](/install-the-collector.md#what-runs-afterwards). |

## What this beta does not do

Each line is a fact about the closed beta, validated on the date at the top of this page.

**Access**

- Every page of the app sits behind sign-in. A program or an agent cannot fetch them; this handbook is the public
  text.
- Only invited addresses sign in. There is no public sign-up.

**Agents**

- Claude Code is the only client seen working. Codex, claude.ai and Claude Desktop are not checked yet.
- Claude Desktop set up for a third-party cloud, and Claude in Slack, do not connect.
- The service tells an agent what to do with a profile. It cannot make an agent comply.
- An agent is told to hold a request of a kind the colleague does not decide. The server's instructions do not spell
  out whether a request for a review or an opinion counts as such a request.
- A profile carries no free text to an agent: free notes are stored and never served.

**The Collector**

- It runs on macOS 26 or later, and nowhere else.
- It counts Claude Code sessions. Codex sessions are not counted.
- It is installed with Homebrew only. No install script is published.
- It does not update itself. Updates come through `brew upgrade humanload`.
- The build is not signed or notarized by Apple.
- Settled questions are not measured: `asks_decided` and `asks_recommended` are sent as `null`.
- No command prints a batch before it is sent.
- The Evening note dialog has no off switch.
- One person pairs five Devices at most.

**The service**

- No AI model runs on the service.
- The database is not encrypted per person: the operator of this beta can technically read stored rows.
- Counts, notes and profiles are stored in the EU; the service's code runs where Cloudflare places it.
