# Quickstart Take one GitHub repository from sign-up to its first merged pull request in about ten minutes. The first steps follow Get started, the card above Sensei's composer. Each step ticks itself when you finish it. > **Warning: The first deploy needs a model.** A workspace deploy uses workspace Credentials only. > Without usable Credentials, it waits for a workspace admin to fix them. ## Before you begin - A GitHub repository you can install the Kosuke App on. - Workspace Credentials for deploys and workspace tasks. For Sensei, choose your personal Subscriptions or Sensei free. ## Sign up 1. Go to [app.kosuke.ai](https://app.kosuke.ai). Press **Continue with Apple** or **Continue with Google**, or type your work email and press **Continue**. 2. If you chose email, type the 8-digit code Sensei sends you. The code expires after 5 minutes. The Welcome to Sensei screen wakes the assistant, then Sensei opens. You start in your Personal space: the sidebar shows your Personal card and no workspace yet. ## Use Personal or join a workspace A new Personal space includes 50 sandbox hours once and 10 sandboxes at once, and you get 100 Sensei free prompts once. The hours are shared across member compute, have no recurring refill, and stop compute at zero while retaining saved work. Earlier Personal spaces keep their current terms. See [Plans and billing](https://kosuke.ai/docs/workspace/plans-and-billing.md). If a teammate invited you, open the invitation email to join their existing workspace. For a new workspace, press the **+** beside **Workspaces**, or **New workspace** in the account menu. It opens **Book a Demo to unlock more capacity** directly. Booking or closing the dialog does not create a workspace or grant capacity. Existing platform-staff provisioning is separate. ## Connect your subscription Choose your personal source in Settings > You > AI Providers. Under **Default Model**, choose a personal model while you hold a Subscription. With none, only **Free**, with the prompts left, and **Connect a subscription** appear. Free reads Sensei free once selected. To connect a Subscription, open its provider row and sign in. Connecting your first Subscription moves Free work to Subscriptions from its next turn. A running turn keeps its source. Workspace tasks and deploys still use workspace Credentials only. See [AI providers](https://kosuke.ai/docs/workspace/ai-providers.md). ## Import a repository 1. In Get started, press **Import**. Choose Personal or an existing workspace in the New repository dialog. The sidebar's **Import repository** row opens it too. Pick **Import from GitHub**. 2. If the dialog reads "Connect your repositories", press **Install on GitHub**. Pick your repository on GitHub and authorize the Kosuke App. You come back to the dialog. If your GitHub organization already has the app, press **Connect GitHub** under the button instead. 3. Open the **Repository** list and pick your repository. If it is greyed out, click **Install App** beside it and add it on GitHub. You come back to the dialog. 4. Press **Import Repository**. ![The Import Project dialog open over a project board. It reads "Choose a GitHub repository to import" and holds a Repository list, a link to configure the Kosuke GitHub App, and the Import Project button.](https://kosuke.ai/docs/img/import-project.webp) You stay in Sensei, and Get started ticks "Import a repository". The project's first deploy starts. Sensei posts a line such as "You imported storefront into Acme. Its first Deploy started.", and the project's row in the sidebar shows a spinner while the deploy runs. Open pull requests on the repository appear on the Tasks page as sessions. You do not have to wait for the deploy. See [Import a repository](https://kosuke.ai/docs/set-up/import-a-repository.md). To start a new app from a sentence instead, pick **Start from kosuke-starter** in the same dialog, where your deployment offers it. See [Preview and publish](https://kosuke.ai/docs/set-up/preview-and-publish.md#start-from-kosuke-starter). ## Start the first task 1. In Get started, press **Start**. The composer reads "Ship this ticket in storefront: ". 2. Finish the sentence with one small change, the way you would tell a teammate, for example "Show the delivery date on the orders table." Send it. If the first deploy is still running, Sensei files the task to the project's Backlog. It says "Filed Show the delivery date to storefront's Backlog. It starts by itself when the first Deploy lands." Once the deploy has landed, Sensei starts the task at once. Either way, Sensei then posts "Started Show the delivery date in storefront." Get started now reads "You are set up. Sensei takes it from here." Press its X, or just move on: it does not come back. The task runs `/kosuke:ship`. The agent works on a new branch, in a sandbox of its own, and carries the ticket to a pull request ready for review. It stops only when it needs you. The app writes that as an event in the session's thread, and Sensei draws a card there with the buttons to decide it. See [Sensei](https://kosuke.ai/docs/automate/sensei.md#add-work-and-ship-it). ## Follow the deploy The deploy runs on its own. Anything it needs from you, such as a secret only you hold, arrives as a card in a Sensei thread. 1. To watch it, click the project in the sidebar. Its settings open, with the Deploy Chat on the left. The chat adds a line for each phase, such as Creating sandbox, Starting services and Promoting the new sandbox. You can send the deploy agent instructions there too. 2. If the agent asks a question, the message box reads "Answer the deploy agent...". Type your answer and send it. The deploy is done when the chat shows "Deployed: Your project is live." Sensei tells you too, such as "storefront is deployed. 3 services are up." ![A project's Settings view after its first deploy. The Deploy Chat on the left lists Creating sandbox, Starting services and Promoting the new sandbox, then a "Deployed: Your project is live." pill above the message box. The Project settings panel on the right lists the sections Sandbox, Services, Environment, Advanced, Logs and GitHub, and has a Redeploy button.](https://kosuke.ai/docs/img/deploy-agent.webp) If the first deploy fails, the app starts one Recovery Deploy of it on its own. If that fails too, Sensei can draw a card in your Sensei threads with the fix the deploy agent proposes. You can also open the **Logs** tab on the right to see why. See [Deploy your project](https://kosuke.ai/docs/set-up/deploy.md). ## Check the work 1. Click the session's chip in Sensei, or the session under the project in the sidebar. The conversation opens on the left and your app on the right. 2. Open the **Preview** tab and try the change in your app. 3. If something is off, type a correction and send it. A message you send while the agent works waits in Up next, above the message box, and runs when the current turn ends. 4. Open the **Changes** tab to read the diff. If the agent asks you a question, you find it as a card in the session's Sensei thread. You can also answer it in the session. See [Messages, Up next and steering](https://kosuke.ai/docs/sessions/messages.md). ## Get to a pull request `/kosuke:ship` opens the pull request for you. It builds the change, opens a draft pull request, reviews and tests it, and marks it ready for review. The session then moves to Under Review, and a Ready for review banner with the pull request number appears above the message box. Sensei then draws a card in the session's thread to ask your teammates for a review. ![A session with an open pull request. Above the message box, a Ready for review banner shows the pull request number and a Resume button. The Changes tab on the right shows the diff of the session's branch.](https://kosuke.ai/docs/img/session-review.webp) To open the pull request without the rest of the workflow, ask the agent in the chat, or type `/kosuke:open-pr`. Press **Resume**, or send a message, to keep working. See [Open a pull request](https://kosuke.ai/docs/review/open-a-pull-request.md). ## Merge your first PR 1. Open the pull request on GitHub from the number in the banner. 2. Merge it as you would any other pull request. The session moves to Completed, and Sensei removes its sandbox. Next time, once the pull request is approved, Sensei can give you a **Merge** card instead. It is your go-ahead: the pull request merges as soon as GitHub allows it. ## If something goes wrong | What you see | What to do | | ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | "Deploys on GLM are less reliable than on Claude or GPT", or the same warning for Kimi, DeepSeek or Grok, in the Deploy Chat | The deploy still runs. For more reliable deploys, ask an admin to connect Claude or Codex in Settings > your workspace > AI Providers. Then pick a Claude or GPT model in the Deploy Chat header. | | Your repository is greyed out in the New repository dialog | Click **Install App** beside it and add the repository on GitHub. You come back to the dialog. | | "Sessions start when it lands" when you start a session | Ask Sensei to start the session instead. It files it and starts it when the deploy lands. Or add the session to the Backlog and start it then. | | Sensei cannot run its selected source | Fix the Subscription, or use Sensei free if you hold none. See [AI providers](https://kosuke.ai/docs/workspace/ai-providers.md). | | The Preview tab reads "Preview paused" | Press **Start preview**. | For more symptoms and fixes, see [Troubleshooting](https://kosuke.ai/docs/help/troubleshooting.md). ## Next steps - [How Sensei works](https://kosuke.ai/docs/get-started/how-kosuke-works.md) - [Run several changes at once](https://kosuke.ai/docs/guides/run-several-changes-at-once.md) - [Connect your coding agent (MCP)](https://kosuke.ai/docs/interfaces/mcp.md)