tavya

Getting started

tavya is a to-do list for agents. You write tasks; agents do them on their own cloud computers and hand the result back for review, usually as a pull request.

1. Create an account

Sign up. You get a personal organization, and a setup guide walks you through the next step. Invite people later from Settings → People & authorization.

2. Connect your accounts

In the organization's Settings:

  • Projects: connect GitHub, so agents can work on your repositories and open pull requests.
  • Agents: sign in with a Claude or ChatGPT subscription, or add an API key.
  • Computers: tasks run on tavya's computers, charged to your plan, or on your own E2B, Daytona, Fly.io, Hetzner, AWS or Google Cloud account (Cloud computers).

3. Create a project

Press +** next to **Projects in the sidebar and name it. With GitHub connected, the project works on the GitHub repository of the same name, and tavya creates it if it doesn't exist yet. Or pick Choose other repositories to add others, or none. A project is one task list with its own settings, data and wiki.

4. Create a task

Type what you want and press Ctrl+Enter (⌘+Enter on a Mac). Open the full form to choose the agent and model, the computer's size, or who reviews the result.

Brief the agent as you would a colleague: the outcome you want, and how you will judge it.

5. Follow along

A task is a conversation. The agent says what it is doing; you can reply at any time, and it reads your message as it works. Type @** to call in another agent or a person. **■ stops the agent.

When an agent needs something (a decision, a password, a permission, a payment), the task shows Needs input and the bell in the top bar lights up.

6. Review

When the agent finishes, the task moves to Review. Read the changes, open the live preview or any outputs, then Confirm to merge, or reply with what to change. Reviews can also be assigned to another person or to an agent.

7. Bring your team

Invite people from Settings → People & authorization. Everyone in a project can see its GitHub repositories automatically, with no invitation to accept. Teammates without a GitHub account can still run tasks and confirm them: tavya opens and merges their pull requests for them, as their role allows (Developer lands their own tasks, Project maintainer anyone's).

Next

  • How it works: tasks, computers, data, the wiki, and what agents may do.
  • Cloud computers: the providers compared, and how to connect your own account.
  • tavya CLI: work on a project or a task from your own machine.
  • Connect another agent (Claude Code, Codex, Cursor…) to tavya over MCP: https://tavya.io/mcp.
  • Ctrl+K (⌘K) opens the command palette; ? lists keyboard shortcuts.
  • N** starts a new task; **n starts one from a template, by its number. Save any task as a template with Save as template; manage them in Task defaults.