Skip to main content

​
Overview

A workspace is a configuration scope that binds together repository context, user preferences, personas, and org-level policies. Every API request resolves to a workspace — either explicitly via workspace_id or implicitly via your default personal workspace.

​
Workspace hierarchy

Organization workspace (org-wide policies)
  └── Personal workspace (user preferences)
       └── Request parameters (per-call overrides)
Precedence (highest to lowest):
  1. Enforced org policies — cannot be overridden
  2. Explicit request parameters
  3. Personal workspace preferences
  4. Generic defaults

​
Connecting a repository

Link a GitHub repository to your workspace for code-aware responses:
  1. Go to Settings > Workspace in the dashboard
  2. Click Connect repository
  3. Install the a21e GitHub App on the target repository
  4. Select the repository and default branch
Once connected, a21e will:
  • Scan the file tree on every request to identify relevant files
  • Read source code to ground responses in your actual implementation
  • Linkify file paths in responses so you can click through to GitHub

​
Preferences

Set default values that apply to all requests from your workspace:
PreferenceValuesEffect
model_tierauto, economy, standard, premiumDefault model quality
risk_tolerancelow, moderate, highHow conservative the output should be
verbosityconcise, normal, detailedResponse length
toneformal, neutral, casualWriting style

​
Personas

A persona adds custom system instructions to every request in the workspace: 
You are a senior backend engineer working on a Node.js/PostgreSQL stack.
Always prefer functional patterns over OOP. Use TypeScript strict mode.
Explain trade-offs when suggesting architectural changes.
Configure personas in Settings > Workspace > Persona.

​
Organization workspaces

Org admins can set enforced preferences that override personal settings:
  • Enforced model_tier: economy prevents team members from using premium models
  • Enforced risk_tolerance: low ensures conservative outputs across the org
  • Org-level personas apply to all members
Org preferences are set in Settings > Organization > Policies.