# Kosuke documentation

Sensei runs the execution in the cloud and turns it into a generative experience across all
your devices. You keep the decisions. Software is where Kosuke starts: describe a change,
Sensei builds it on a branch of your GitHub repository, you try it in a live Preview, and your
team merges the pull request.

Open [app.kosuke.ai](https://app.kosuke.ai) and follow the [Quickstart](https://kosuke.ai/docs/get-started/quickstart.md),
or watch the Sensei tutorial first.

[Stop babysitting your coding agents](https://www.youtube.com/watch?v=670h4q9UHS8)

## How a change reaches your repository

1. Import a GitHub repository as a project.
2. The import starts the project's first deploy. The deploy agent works out how to run your
   app and starts it in a sandbox. This happens once per project.
3. Press **New Session** and describe the change in plain language.
4. The agent works on its own branch and sandbox. Try the change in the Preview, read the
   diff, and send corrections while it works.
5. Ask the agent to open a pull request. Merge the pull request on GitHub, and the session moves to Completed.

[How Kosuke works](https://kosuke.ai/docs/get-started/how-kosuke-works.md) follows one session through these steps.

## Find your starting point

| You want to                                           | Read                                                                                                                                     |
| ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Take one repository to its first pull request         | [Quickstart](https://kosuke.ai/docs/get-started/quickstart.md)                                                                                                    |
| Ship a change without writing code                    | [Make a change without writing code](https://kosuke.ai/docs/guides/change-without-code.md)                                                                        |
| Run several changes side by side and review the diffs | [Run several changes at once](https://kosuke.ai/docs/guides/run-several-changes-at-once.md), [Review the changes](https://kosuke.ai/docs/review/review-the-changes.md)                     |
| Work in chat sessions every day                       | [Chat sessions and tasks](https://kosuke.ai/docs/sessions/chat-sessions.md), [Messages, Up next and steering](https://kosuke.ai/docs/sessions/messages.md)                             |
| Set up AI providers, members and billing as an admin  | [AI providers](https://kosuke.ai/docs/workspace/ai-providers.md), [Members and roles](https://kosuke.ai/docs/workspace/members-and-roles.md), [Plans and billing](https://kosuke.ai/docs/workspace/plans-and-billing.md) |
| Connect your coding agent to Kosuke | [Integrate Kosuke](https://kosuke.ai/docs/integrate.md) |
| Drive Kosuke from your own coding agent or a script   | [Connect your coding agent (MCP)](https://kosuke.ai/docs/interfaces/mcp.md), [Kosuke CLI](https://kosuke.ai/docs/interfaces/cli.md), [the Kosuke API](https://kosuke.ai/docs/api.md)                                |
| Look up a word                                        | [Glossary](https://kosuke.ai/docs/get-started/glossary.md)                                                                                                        |

## Get help

Email [support@kosuke.ai](mailto:support@kosuke.ai). For common problems and their fixes, see
[Troubleshooting](https://kosuke.ai/docs/help/troubleshooting.md).

## Next steps

- [Quickstart](https://kosuke.ai/docs/get-started/quickstart.md)
- [How Kosuke works](https://kosuke.ai/docs/get-started/how-kosuke-works.md)