Get Pro free for a public repository

If your repository is public, you can use Thrum Pro in it at no charge. Register the repository once, in three steps.

What the grant is

The grant gives you the Pro features for one public repository. It does not give you a plan for your account. Other repositories on the same machine stay on the plan you already have.

With the grant, you can use these in that repository. Reading what is already saved is always free.

Memory: saved, titled notes that later sessions and other agents can search.
Personal state: a short note each agent keeps about its own status and next actions.
Work queue: the list of work an agent has committed to.
Dashboard tab: the document an agent shows on its own Dashboard tab.
Advanced sharing: sharing between paired machines, including watching and typing into the Terminal of an agent on the other machine.
Typing to an agent from the web UI: typing into an agent’s Terminal tab in the web UI.
Conversation view: an agent’s Conversation tab and the Conversations page.
Email bridge: your agents’ messages reach your mailbox, and your replies go back to them.
Email notifications: a copy of every message addressed to you, sent through a mail server you choose.
Vault: an encrypted store on your machine for secrets such as passwords and tokens.

Which repositories qualify

Your repository must be public on one of these hosts:

github.com
gitlab.com
bitbucket.org
codeberg.org
dev.azure.com (including the older *.visualstudio.com addresses)

Thrum checks that the repository is public on the host. It does not look at a licence file, so a public repository qualifies whichever licence it carries, or none. A private repository does not qualify. Self-hosted servers on other domains do not qualify either.

Register in three steps

You type these steps in a terminal. The licence belongs to you and your machine, not to a project or an agent, so you set it up yourself before you talk to your coordinator.

Create your account at my.thrum.team and confirm your email address.
Link this machine to your account. The command prints a link. Open it in a browser and click Activate.
```
thrum license activate
```
From inside the repository, register it. Run this in each repository you want to cover.
```
thrum license oss-register
```

Thrum sends nothing about a repository until you ask it to register that repository. The command sends your repository's origin address, its ID and its latest commit, and prints a line saying so first. It also sends this machine's licence credential and installation ID, so the server knows the request comes from your licensed machine. The server decides whether the repository is eligible. The repository needs an origin remote on one of the hosts above, and you need to have pushed or fetched at least once.

What happens next

The grant belongs to the machine that registered. Run the command on each machine where you work on the repository.
The licence server re-checks every 30 days. If a re-check finds the repository is no longer public, it checks again 7 days later, and ends the grant only if it is still not public.
A host that cannot be reached does not block you. If the host cannot be reached or gives no clear answer, the registration is granted anyway, and the next re-check tries again.

The full steps, the success check and what to do if the command is rejected are in Get Pro free for a public repository.