Integrations

Integrations connect your assistants to the tools you already use: your code host, your mail, your calendar, your issue tracker. An assistant that can see the right tool does better work, and an assistant that has to ask you for every detail does not.

Today three integrations are available, all for source control: GitHub, GitLab, and Bitbucket. Every other integration on this page is Coming soon.

How integrations work#

1. Create an access token in the tool. Give it only the permissions the assistant needs. Each page lists them in plain words.
2. Connect it. In the StellarFirm desktop app, open Integrations, pick the tool, paste the token, and press Connect.
3. Ask for the work. In chat, tell the assistant what you want. It uses the tool without you pasting anything again.

The desktop app keeps your token on your computer. It is never shown back to you after you connect: the page shows only that the tool is connected. You never paste a token into a chat message.

Reads on its own, or waits for your Approve#

Every ability falls into one of two groups, and each integration page tells you which.

Every integration#

Which assistants use which tool#

Every connected tool is shared by your assistants, and each one uses the tools that fit its job. Today the Coder is the assistant that is available, so source control is where integrations matter first. The other assistants arrive with the tools that suit them, such as mail for the Accountant and Legal.

An assistant never pretends a tool is connected. If you have not connected it, the assistant leaves it out and tells you.

Preflight checklist#

Before you connect a tool:

• You have the StellarFirm desktop app and are signed in.
• You can create an access token in that tool.
• You know the smallest set of repositories, folders, or projects the assistant should see.
• You have decided what your house rules allow without asking.

Talk to your assistants from chat tools#

Chat tools are where you hand work over without opening StellarFirm. Slack, Telegram, and Discord are Coming soon, and Microsoft Teams is not connected yet. Until then, delegate in the StellarFirm chat. Delegate work compares every place you can hand work to your assistants.

Staying in control#

• Connect with the least access that works. You can always make a token wider later.
• Disconnect at any time. Revoke the token in the tool itself and the assistant loses access straight away.
• Check what happened. Jobs and Approvals keep a record of what each assistant did with each tool. See the activity log.

Prompt#

CEO, which of my integrations are connected, and which assistant would use each one? Tell me what you would not be able to do without the ones that are missing.