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 viaworkspace_id or implicitly via your default personal workspace.
Workspace hierarchy
- Enforced org policies — cannot be overridden
- Explicit request parameters
- Personal workspace preferences
- Generic defaults
Connecting a repository
Link a GitHub repository to your workspace for code-aware responses:- Go to Settings > Workspace in the dashboard
- Click Connect repository
- Install the a21e GitHub App on the target repository
- Select the repository and default branch
- 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:Personas
A persona adds custom system instructions to every request in the workspace:Organization workspaces
Org admins can set enforced preferences that override personal settings:- Enforced
model_tier: economyprevents team members from using premium models - Enforced
risk_tolerance: lowensures conservative outputs across the org - Org-level personas apply to all members