Slack integration

Connecting Slack

Choose Connect on the Slack card and approve the install on slack.com. That adds the Spaceboy app to your Slack workspace and stores the workspace connection under your organization. One Slack workspace connects to one Spaceboy organization.

Creating a project from Slack

Describe the site and the setup wizard runs right in Slack — the same pipeline as the dashboard: a derived plan with its checkpoint roadmap and cost estimate first, then the agent builds toward the first checkpoint and publishes it to your development environment.

/repobot create A dog park community site with memberships, an events calendar, and photos
/repobot create go

The first command replies (only to you) with the derived project, plan digest, checkpoint roadmap, and estimated cost; create go starts the first checkpoint, links the channel to the new project, and posts a live-updating status message. Long builds hand off to the dashboard's progress page, and the checkpoint-ready notification lands in the channel. Review each checkpoint from your sandbox, then `/repobot next` starts the next one.

Build knobs ride along as key=value tokens anywhere in the description: strict=true turns on strict design review (the run reworks until the build matches the designs), model=<id> picks the model conducting the run, and name="Project Name" fixes the project's name (quotes carry spaces).

/repobot create strict=true name="Dog Haven" A dog park community site with memberships and events

To steer the design with images, DM the bot (or @mention it) with create <description> and the images attached — slash commands can't carry files, but chat messages can. The attached images become design inspiration exactly like the wizard's uploads, and the same plan digest posts in the thread; start it with /repobot create go.

Linking channels to projects

Each channel chats with exactly one project. In the channel, run the slash command to link it:

/repobot link storefront

Use the project's exact name from the dashboard. Re-run the command to point the channel at a different project, `/repobot unlink` to remove the link, and `/repobot status` to see what's linked. Direct-message conversations with the bot are linked the same way — run the command inside the DM.

Handing the agent a task

For work you want to fire and forget, hand it off as a tracked task instead of a chat message — no open workspace needed:

/repobot task Add a testimonials section to the landing page

The task builds in its own isolated workspace, merges back, and auto-promotes to production once the repository's release checks pass — Slack gets a link to follow it, and the result lands back in the channel when it's done. You can also deploy from Slack: /spaceboy deploy for development, /spaceboy deploy production for a checked production release.

Chatting with the agent

Mention @Spaceboy in a linked channel (or just message the bot in a DM) and your message goes to the linked project's agent — the same agent you chat with in the workspace. The reply is posted in a thread on your message, and follow-ups inside that thread continue the same conversation.

• Your Slack account is matched to your Spaceboy account by email; each teammate chats as themselves.
• Messages ride your running workspace session, so your workspace for the linked project must be open in the dashboard.
• Long runs post the reply when the agent finishes; you can always watch live progress in the workspace.

Troubleshooting

• "Workspace isn't running" — open the project's workspace from the dashboard link in the bot's reply, then ask again.
• "Couldn't match your Slack account" — your Slack email must match your Spaceboy account email; ask an admin to invite that address to the organization.
• "Channel isn't linked" — run /repobot link <project> in the channel first.