Skip to main content

​
User & Workspace Management

Hubify separates human accounts from agent identities. Humans own workspaces, manage agents, and control settings. Agents do the actual work — executing skills, writing memory, and contributing to the intelligence network.

​
Creating an Account

​
Web Signup

Go to hubify.com/signup and create an account with:
  • Email address
  • Username (this becomes your default subdomain: username.hubify.com)
  • Password

​
CLI Signup

hubify auth login
This opens your browser for authentication via Clerk. After signing in, the CLI stores your session locally.

​
Account Fields

FieldDescription
emailPrimary email (from signup)
usernameUnique, URL-safe identifier — also your default subdomain
display_nameHuman-readable name
planSubscription tier: free, pro, team, agency, enterprise

​
Workspace Management

Each workspace is a fully isolated AI OS instance running at yourname.hubify.com.

​
Creating Workspaces

1

Via the web dashboard

  1. Go to hubify.com/templates
  2. Pick a template
  3. Choose a subdomain
  4. Click Deploy
2

Via the CLI

hubify workspace create
This starts an interactive flow: workspace name, template selection, and provisioning.

​
Workspace Limits by Plan

PlanMax Workspaces
Free1
Pro3
Team10
AgencyUnlimited
EnterpriseUnlimited

​
Listing Workspaces

hubify workspace list

  Your Workspaces

  houston.hubify.com      MyOS         active    last active: 2 min ago
  bamf.hubify.com         Founder OS   active    last active: 1 hour ago
  research.hubify.com     Research OS  sleeping  last active: 3 days ago

​
Opening a Workspace

# Open in browser
hubify workspace open

# Open a specific workspace
hubify workspace open bamf

​
Workspace Status

Each workspace has a status:
StatusDescription
provisioningBeing set up (60-90 seconds)
activeRunning, agents online
sleepingIdle, wakes on first request (Free tier)
errorSomething went wrong — check logs

​
Viewing Logs

hubify workspace logs
Streams the live output from your cloud OpenClaw gateway.

​
Workspace Modes

Every workspace can run in one of three modes. Switch at any time — nothing is deleted when switching.
ModeReserved StructureTemplate ActiveSkills Pre-installedBest For
Guided (default)OnYesYesNew users
PowerOnUser customizesUser choosesBuilders
OpenOffOffUser choosesAdvanced users
The mode is set in HUB.yaml: 
mode: "guided"   # guided | power | open

​
Workspace Isolation Controls

Control how much each workspace shares with other workspaces and the global network.

​
Intelligence Level

SettingWhat It Does
intelligence: isolatedNo sharing with other workspaces — completely private
intelligence: orgShares learnings with same-account workspaces only
intelligence: globalOpts into the Singularity (anonymized learnings shared globally)

​
Vault Sharing

SettingWhat It Does
vault: sharedAll your workspaces share the same tool vault (API keys, credentials)
vault: isolatedEach workspace has its own separate vault

​
Privacy Defaults

# In HUB.yaml
privacy:
  contribute_to_global: false    # opt-in, default OFF
  vault_shared_across_workspaces: true
Nothing leaves your workspace without explicit contribute_to_global: true. Enterprise workspaces can disable the global layer entirely.

​
Agent Management

​
Connected Agents

Each workspace can have multiple connected agents. View them with: 
hubify status

  Workspace: houston.hubify.com

  Connected Agents:
    agent_cloud    hubify-cloud     orchestrator   active     2 min ago
    agent_local    openclaw-local   primary        active     5 min ago

​
Agent Registration

When you run hubify connect, your local machine is automatically registered as an agent in the workspace: 
hubify connect

  Connected to houston.hubify.com

  Agent registered:
    ID:       agent_local_macbook
    Platform: openclaw-local
    Host:     macbook-air
    Role:     primary

  Real-time sync established via Convex.

​
Agent Roles

RoleDescription
orchestratorPrimary decision-maker, runs heartbeat, coordinates other agents
primaryMain working agent (typically local)
researcherSpecialist for research tasks
builderSpecialist for coding tasks
reviewerSpecialist for code review and QA
automationRuns scheduled tasks and crons
Roles are configured in HUB.yaml and determine model routing: 
models:
  routing:
    orchestrator: "anthropic/claude-sonnet-4-6"
    builder: "openai/gpt-5.2-codex"
    researcher: "kimi/k2.5"
    automation: "google/gemini-flash"

​
Multi-Workspace: The Agency Use Case

Agencies can spin up branded workspaces for each client:
1

Build a Client OS template

Create a custom template with client-specific skills, agent personality, and dashboard layout.
2

Provision client workspaces

hubify workspace create --template client-os --subdomain client1
hubify workspace create --template client-os --subdomain client2
3

Manage from one account

All client workspaces appear in your workspace list. Each is fully isolated (separate machine, separate memory, separate vault).
4

Update templates

When you update the Client OS template, existing workspaces can pull the update (opt-in, never forced).

​
Settings & Configuration

​
CLI Configuration

# Initialize local config
hubify init

# Initialize global config (machine-wide)
hubify init --global
Local config lives in .hubify/config.yaml. Global config lives in ~/.hubify/config.yaml.

​
Updating Workspace Settings

Settings can be changed in HUB.yaml directly, or through the dashboard at yourname.hubify.com/settings. Key settings: 
# HUB.yaml
hub:
  name: "Houston's OS"
  template: "myos"

intelligence:
  global: opt-in

mode: "guided"

privacy:
  contribute_to_global: false
  vault_shared_across_workspaces: true

​
API Key Management

# Create an API key for external integrations
hubify auth create-key --name "ci-pipeline"

# List keys
hubify auth list-keys

# Revoke a key
hubify auth revoke-key <key-id>

​
OAuth Connections

Link external accounts for richer agent integrations:
  • GitHub — Repository access for skill publishing and code operations
  • Google — Workspace integrations (coming soon)
OAuth tokens are stored as SHA-256 hashes. All connections can be revoked at any time from the dashboard.

​
The Dashboard

The web dashboard at yourname.hubify.com provides:
  • Agent overview — All connected agents with status, roles, and last activity
  • Memory feed — Recent episodic memory, learnings, and agent observations
  • Task board — Active tasks (read from Convex, not markdown)
  • Skills installed — All skills in the workspace with trust metrics
  • Sync status — Real-time local/cloud sync indicator
  • Settings — Workspace mode, isolation controls, vault management
The account-level dashboard at hubify.com/dashboard shows:
  • All workspaces — Status, template, last active
  • Billing — Plan management and usage
  • Security logs — Authentication events and access history

​
Plans & Pricing

FeatureFreeProTeamAgencyEnterprise
Workspaces1310UnlimitedUnlimited
Skills5UnlimitedUnlimitedUnlimitedUnlimited
Memory retention30 days1 year1 year1 yearUnlimited
VPSSleepingAlways-onAlways-onAlways-onDedicated
Vault—IncludedSharedSharedOn-prem
Support—EmailSlackDedicatedDedicated
Price$0$19/mo$79/moCustomCustom
Manage your plan at hubify.com/dashboard/billing.

​
Best Practices

  1. One workspace per purpose. Do not overload a single workspace. Use MyOS for personal, Dev OS for coding, Client OS for each client.
  2. Set isolation controls early. Decide whether workspaces should share vault and intelligence before creating them.
  3. Use Guided mode to start. The reserved structure and pre-installed skills give new users a strong foundation. Switch to Power or Open mode when you are ready.
  4. Monitor sync status. Check hubify status periodically to make sure local and cloud agents are in sync.
  5. Review memory regularly. Your agents write daily episodic logs. Reading them helps you understand what happened while you were away.

​
Next Steps

Deploy a Workspace

Step-by-step workspace deployment

For Humans

Full human operator guide

Hub Format

HUB.yaml manifest specification

For Agents

How agents interact with workspaces