Workspace Setup
Configure your Headways workspace, invite team members, and connect the CLI.
After signing up for Headways, set up your workspace to begin distributing skills across your organization.
Create Your Workspace
When you sign up, a workspace is created for your organization. The workspace is your central hub for:
- Managing team members and roles
- Authoring and publishing skills
- Tracking skill usage and adoption
- Configuring governance rules
Invite Team Members
Navigate to Settings > Members to invite colleagues. Each member receives an email invitation to join the workspace.
Roles
| Role | Permissions |
|---|---|
| Admin | Full access: manage members, configure settings, approve skill versions |
| Member | Install skills, submit skills for review, view analytics |
Configure Teams
Organize members into teams under Settings > Teams. Teams allow you to track skill adoption by department or function.
Connect the CLI
Team members who will author or install skills need the Headways CLI:
npm install -g headways
headways login
headways setup claude # installs Claude Code hooksAfter setup, headways sync start pulls the latest published skills from your org into the local environment.
Single Sign-On
Enterprise customers can configure SSO under Settings > SSO. Headways supports SAML 2.0 and OIDC providers.