Skip to guide
IndigoIndigo · HQ Field Guide
Chapter 02 / 15Contents
Chapter 02admin · 16 min

Admin setup path

Create the company foundation in the right order: install, set up HQ, prepare sync, create the company, and invite the first teammate.

01Install HQ and create the company foundation in the right order.
02Make the company clean, synced, and invite-ready before anyone else joins.
$ /newcompany {company-slug}
Fig 02.0 · Laying the foundation
The concept

Foundation

You establish the trusted base before anyone else syncs into it.

BUILD THE TRUSTED BASE BEFORE ANYONE JOINSSETUP FOUNDATIONBUILD ORDER · LEFT TO RIGHTSTAGE 01INSTALL HQBASE PLATETHENSTAGE 02SECURECOMPANYBOUNDARYTHEN INVITESTAGE 03INVITETEAMMATE JOINS
Fig 02.1 · Install and set up
Step 01Foundation

Install and set up HQ

Setup starts by answering one useful question: who are you, what company are you working for, and what do you do there?

Run the installer, complete setup prompts, keep the generated Documents/HQ workspace, and answer in role language rather than tool language.

HQ opens a fresh session without asking to repeat the base setup.
npx create-hq/setup
Step 02Boundary

Create company boundary

A company is the isolation boundary for context, policies, credentials, projects, workers, knowledge, and memory.

Run the create-company flow from the active HQ workspace, verify the generated manifest entry, and do not store secrets until the company name is correct.

The company appears in the HQ manifest and future sessions can select it.
/newcompany {company-slug}/startwork
Fig 02.2 · The company boundary
Fig 02.3 · The first invite
Step 03Invite line

Prepare sync and invite

Shared team gains come from one person's useful knowledge becoming available to the next person without collapsing company boundaries.

Run sync, resolve conflicts if any appear, then create the teammate invite from the active company and verify the pending member.

The teammate can accept the invite and sync the same company.
/hq-sync/invite teammate@example.com
Commands

Keep the chapter executable.

Create company
$ /newcompany {company-slug}

Creates the company boundary, manifest entry, and workspace homes.

Admin sync
$ /hq-sync

Confirms the company is cloud-backed and conflict-free before inviting teammates.

Invite command
$ /invite teammate@example.com

Starts the invite flow from the active company boundary.

References

What to keep in mind.

Setup order

Install HQ, set up HQ, set up sync, create the company, invite the first teammate.

Stop rule

Do not invite teammates into a company with unresolved sync conflicts, the wrong active company name, or unverified starter context.

Next
Next move

Once the company foundation is clean, use the join path so invite recipients do not create duplicate companies.

Continue to teammate join
Part 02 · Admin setup pathIndigo · HQ Field Guide