Offices

Organize your AI agents into workspaces with independent billing and settings

What It Is

An Office (workspace) is where your AI team lives. Each Office has its own agents, chat history, tasks, integrations, memory, and billing. Think of it as a virtual company with AI employees — visualized as a pixel art Terraria-style building in the AVA home screen.

How to Use It

Creating an Office

During onboarding or when adding capacity:

1. Company Name — Your workspace identifier
2. CEO Name — Your name within the workspace
3. Timezone — Used for scheduling and time-aware tasks
4. Pixel Logo — Choose from pixel art building icons

Office Setup Flow

The onboarding flow handles workspace creation in sequence:

1. CompanySetupView — name, CEO name, timezone, logo
2. AgentSetupView — create your first Orchestrator
3. PaywallView — choose Standard or Premium tier
4. StaffingView — bulk hire pre-built agent teams

For subsequent offices, the PaywallView appears in atCapacity mode when you've reached your agent limit.

Subscription Tiers

Managed via StoreKit 2 with RevenueCat for entitlement management. 10 subscription groups (one per office), each with Standard/Premium tiers. Upgrades handled in upgradeOnly mode.

What You Need to Know

Workspace Isolation

Each office is fully isolated:

• Agents — Cannot access other workspaces
• Memory — Per-workspace memory with separate caps
• Integrations — Composio connections are workspace-scoped
• Billing — Independent spend tracking and caps per office
• Files — Uploaded documents and S3 artifacts are workspace-specific

Scaling

• Maximum 10 offices per account
• Up to 100 agents total (10 offices × 10 agents at Premium)
• Mix tiers freely — Standard for small projects, Premium for heavy workloads
• Upgrade in-place — Promote Standard to Premium for +$10/mo

Office Visualization

The HomeView displays your office as a pixel art 10-floor building:

• Agents appear at desks when active, sleeping when idle
• Multi-office pagination with horizontal scroll
• Bottom sheet for quick access to agents, tasks, and settings

Tips

• One office per project or client. Keeps context, memory, and billing separate.
• Start Standard, upgrade if needed. 5 agents handles most individual workflows.
• Use pre-built teams. StaffingView offers ready-made team configurations for common workflows during setup.

FAQ

Can I move agents between offices? No. Agents are tied to their workspace. Create new agents in the target workspace instead.

What happens if I cancel a subscription? The office becomes read-only. You can still view history but agents can't perform actions. Resubscribe to restore full access.

Can I share an office with other people? Office collaboration features are planned for a future release. Currently each office is single-user.