Skip to content
StellarFirmStellarFirm
Join waitlist
Mission manual
Esc

Type a word to search every page. Try , or .

Module 01 · Getting started

Your first goal

The demo path from an empty chat to a pull request: connect your code, set a goal for the Coder, approve the risky step, and review the result.

View as Markdown
On this page

This page walks you through one complete flight: you set a goal, the Coder works in its own workspace, the CEO assistant brings the risky step to you, you approve it, and you get a pull request. It takes a few minutes of your attention. The Coder does the rest.

Preflight checklist#

  • You are signed in.
  • You have a repository on GitHub, GitLab, or Bitbucket that you are happy for the Coder to work on. A small or test repository is a good first choice.
  • You can create an access token on that service, or already have one.

Step 1: Connect your code first#

The Coder cannot work on a repository it cannot see, so connect your source control before your first goal.

  1. Open Integrations.
  2. Choose GitHub, GitLab, or Bitbucket.
  3. Follow the setup steps on that page. You create an access token on the service, with permission to read the repository and to open pull requests, and paste it into StellarFirm.
  4. Save. The integration shows as connected.

GitHub, GitLab, and Bitbucket are the integrations available today. Everything else, such as Slack and Gmail, is Coming soon.

Step 2: Open chat and set a goal#

  1. Open the chat at stellarfirm.ai/app.
  2. Write your goal and name the Coder at the start. Name the repository, say what you want, and say what "done" looks like.
PromptYour first goal
Coder, in [repository], fix [the problem or small feature you want]. Keep the change small, run the tests, and open a pull request for review. Tell me what you changed.

Naming the Coder sends the message straight to it. Without a name, the CEO assistant picks the right assistant for you. Today that is the Coder. See routing.

Step 3: Watch the Coder work#

The Coder works in its own private workspace, a computer of its own. You can follow along in three places.

WhereWhat you see
ChatShort updates: Working, then what it found, then Done.
JobsThe job for this goal, and the Coder's actual changes when you expand it.
ComputerThe assistant's computer, with its files and terminal.

While the Coder works, the terminal shows each command it runs and its output, read only. You do not need to do anything. You can leave and come back.

Step 4: Approve the risky step#

Editing files in the Coder's workspace is safe, so it does not stop you. Opening a pull request affects your repository, so the CEO assistant holds it for you.

  1. Open Approvals, or look for the request under the messages in chat.
  2. Read the request. It says what the assistant wants to do and where.
  3. Choose Approve to let it go ahead, or Reject to stop it. Nothing is sent if you reject.

Step 5: Get your pull request#

After you approve, the Coder pushes its work to a new branch and opens a pull request on your repository, then posts the link in chat. By default, a first-run pull request is a draft, so it waits for your review.

What to check in the pull request#

  1. The title and description. Do they say what you asked for?
  2. The changed files. Is the change small and in the right place? Anything unexpected is worth a question.
  3. The tests. Did they run, and do they pass? The description reports what the Coder ran.
  4. The branch. Is it a new branch and not your main branch?
  5. Your own review. Read the diff the way you would read a teammate's.

If something is off, reply in chat and ask the Coder to adjust it.

PromptAsk for a change
Coder, on the pull request you just opened, [what to change]. Update the same branch and tell me when it is ready.

What to try next#

  • Ask the Coder to review an open pull request.
  • Hand it a bug with a clear symptom.
  • Write a company brief and house rules so every assistant knows how you work.
  • Run several Coders at once on different goals.
PromptReview a pull request
Coder, review pull request [number] on [repository]. Summarise what it changes, flag risks, and list anything missing from the tests. Do not change the code.
PromptFix a bug
Coder, users report that [symptom] on [repository]. Find the cause, fix it in the smallest change, add a test if one is missing, and open a pull request for review.
PromptAsk what is possible
CEO, what can the Coder do for me with [repository] right now, and what would you suggest I hand over first?

Checkpoint#

You have finished the flight when you have:

  • connected a source control integration,
  • set a goal and watched the job run,
  • approved a step on Approvals,
  • and reviewed a pull request.

Next#