agex.dev
Guides

Team Setup

Set up agex for your team — shared artifacts, org workspaces, and onboarding with one command.

The goal

New team member joins → clones repo → runs agex sync → entire agentic coding environment is configured. No wiki, no "ask Dave for the CLAUDE.md", no manual file copying.

Step 1: Initialize your project

cd your-project
agex init

Select your platforms (Claude Code, Cursor, etc.) and stack. This creates agex.toml.

Step 2: Add your team's artifacts

# Add rules
agex add @your-org/team-rules

# Add skills
agex add @your-org/deploy-recipe

# Add MCP server configs
agex add @your-org/supabase-mcp

# Add hooks
agex add @your-org/eslint-pre-edit

Each agex add updates your agex.toml and syncs the artifact to disk.

Step 3: Commit agex.toml

git add agex.toml
git commit -m "chore: add agex config for team agent setup"
git push

Step 4: Team onboarding

When a new team member clones:

git clone your-repo
cd your-repo
agex sync

Done. Their Claude Code, Cursor, or whatever platform they use is fully configured.

Using organizations

For private artifacts and team management:

  1. Create an org at /app/orgs/new
  2. Invite team members
  3. Publish team artifacts under the org: @acme-corp/team-rules
  4. Private artifacts are visible only to org members

Example agex.toml

[project]
name = "acme-web-app"
version = "0.1.0"
tools = ["claude-code", "cursor"]
stack = ["typescript", "nextjs", "postgres"]

[rules]
team-rules = "@acme-corp/team-rules"
testing = "@acme-corp/testing-conventions@2"

[skills]
deploy = "@acme-corp/deploy-recipe"
db-migrate = "@acme-corp/db-migration-skill"

[mcp]
supabase = "@agex-community/supabase-mcp-config"
github = "@agex-community/github-mcp-config"

[hooks]
lint = "@acme-corp/eslint-pre-edit-hook"

Keeping things up to date

# Check for updates
agex update --check

# Apply updates
agex update

# Check environment health
agex status

Claude Code marketplace integration

agex can register as a plugin source for Claude Code:

agex init  # Select Claude Code → registers agex marketplace

This adds agex to .claude/settings.json, so Claude Code can install agex artifacts as native plugins.

On this page