Confluence

Connect Confluence Cloud so the AI can search your wiki, and keep Blueprints in sync with Confluence pages automatically.

This feature may need to be enabled for your workspace.

Overview

The Confluence Connection does two things:

Context search — Confluence pages are indexed so the AI can draw on your team's documentation when generating Briefs, answering questions in Chat, and planning work. Teams that keep their architecture decisions, design specs, and product knowledge in Confluence get that context automatically — without copying anything into Hamster.

Two-way Blueprint syncBlueprints mirror to pages in your chosen Confluence space, and Confluence pages your team tags as part of the sync appear as Blueprints in Hamster. Edit either side and the other stays current.

You can connect Confluence for context search only, or enable two-way sync at the same time. If you start with context only, you can add sync later without reconnecting.

The Connection uses Atlassian OAuth — the same login flow as Jira if you already have that connected.

What the AI Can Access

When context search is active:

  • Pages — full text content of pages in the connected space
  • Page structure — hierarchy and nesting of pages in the space
  • Page metadata — titles, last modified dates, authors

The AI searches Confluence at the time of your request, so results always reflect the current state of your space.

What Two-Way Sync Does

When two-way sync is enabled:

  • Every Blueprint you create or edit in Hamster is mirrored to a matching page in your connected Confluence space, nested under a Hamster root page the Connection manages.
  • Confluence pages your team marks for sync appear as Blueprints in Hamster — with their full content converted so the AI can read and reference them.
  • Edits made in Confluence flow back to the matching Blueprint. Edits made in Hamster flow to the Confluence page. Both sides stay current without any manual copying.

A sync badge appears on each Blueprint that has a linked Confluence page. Click the badge to open the page in Confluence.

How to Connect

  1. Go to Settings > Connections and click the Confluence card.
  2. Click Connect with Confluence.
  3. You are redirected to Atlassian's authorization page. Log in with your Atlassian account.
  4. Back in Hamster, select which Confluence space to connect.
  5. Choose whether to enable two-way Blueprint sync, or start with context search only.
  6. Click Confirm.

Confluence page indexing begins immediately. If you chose two-way sync, the first reconciliation run creates the Hamster root page in your space and links any existing Blueprints.

Enable sync on an existing connection

If you connected for context only and want to add two-way sync:

  1. Go to Settings > Connections and open the Confluence connection.
  2. Click Enable Sync.
  3. Confirm — your previously chosen space is already selected.

Multiple Confluence sites

You can connect more than one Confluence site to the same Hamster workspace. Each connection links to a specific site and space. Connect additional sites from the Confluence card in Settings > Connections.

Marking Confluence Pages for Sync

Two-way sync watches your connected space for pages your team wants to manage in Hamster. To bring a Confluence page in as a Blueprint, add the hamster label to it in Confluence. The next sync picks it up and creates the matching Blueprint.

Pages that Hamster creates are labelled automatically — you do not need to label them manually.

Permissions Requested

Hamster requests the minimum permissions needed for context search and page sync:

  • Read pages and spaces
  • Write pages (to create and update mirrored Blueprint pages)
  • Read and write labels (to manage the sync gate)
  • Offline access (to refresh your session without prompting you to log in again)

No other Confluence data is accessed.

Tips

  • Connect the space where your team keeps architecture decisions, product specs, and reference docs. The AI draws on this content every time it generates a Brief or answers a question about your product.
  • If your team uses both Confluence and Notion, you can connect both. The AI draws on all connected sources.
  • Two-way sync is useful when your engineering team expects to read and edit Blueprints in Confluence rather than opening Hamster directly. Any team member can update the Blueprint by editing the linked Confluence page.
  • If you connect Confluence and Jira, you get both the wiki and the tracker feeding into your Context Graph — useful for teams that run their entire workflow on Atlassian tools.

Related