Menu

Using OpenTodo GuidesVersion 0.6.0

Assistant settings

Settings, Integrations, the Assistant card: the provider and model in use, this month's usage, and the switch Apply small changes without review.

On this page

Settings → Integrations → Assistant holds your consent, which assistant you use, this month's usage, Apply small changes without review (this device) and Clear conversations on this device. The owner's part of the card is described in Set up the assistant.

Use your own provider and key#

When the server owner turns on Let members bring their own key, Settings → Integrations → Assistant shows Which assistant you use:

  • The server's assistant: the provider and model the owner set up. This is the default.
  • My own provider and key: choose Anthropic (Claude), OpenAI or Google Gemini, a model, and paste an API key from your own account, then select Save my provider. For Anthropic you pick one of the offered models; for OpenAI and Gemini you type the model id (up to 100 characters: letters, digits, ., _, : and -, for example gpt-4.1-mini or gemini-2.5-flash). Test connection sends one tiny request with the provider, model and key on screen to check them, before or after you save (up to 5 tests in 10 minutes). Testing never saves anything.

Your questions then go from this server to the provider you chose, with your key, so that provider's terms for your account apply. The assistant asks you to accept the disclosure for that provider before your next message. Your key is stored on the server, never shown again, never sent to your browser and never in backups or exports. Going back to The server's assistant deletes the key you stored for your provider.

A compatible endpoint (a model server address) is never offered here: only the server owner decides which other machines the server connects to.

If the owner later stops allowing members' own keys, your choice is kept but not used: the server's assistant answers (after you accept its disclosure) until the owner allows it again. Forget my provider and key deletes both.

If you saved a key in an earlier version of OpenTodo, it still works with the server's assistant; Remove my key deletes it.

Answers on your own key are paid by you; how they count is explained under Costs and limits.

Apply small changes without review#

The switch Settings → Integrations → Assistant → Apply small changes without review (this device) is off by default. When it is on, a proposal that touches at most 3 existing tasks and only changes completion, due dates, priority or labels is applied at once, with an Undo notice. Anything else, including every new task, every move to another project or section, every deletion and every text edit, is always shown for review.

Edit this page on GitHub