init

name	init
description	Initialize team config for a project. Creates .agenteam/config.yaml (or legacy agenteam.yaml) and generates .codex/agents/*.toml.

AgenTeam Init

Set up AgenTeam for the current project.

Process

1. Check Prerequisites

Resolve the runtime path first, then use the runtime entrypoint itself as the readiness check. Do not spend time on separate environment probes if the runtime can tell you what is missing.

Fast path:

python3 <plugin-dir>/runtime/agenteam_rt.py --help

If Python or dependencies are missing, the runtime prints a JSON error. Only then offer the minimal install fix:

pip install pyyaml toml

2. Check for Existing Config

Check for config in this order:

1. .agenteam/config.yaml (personal)
2. .agenteam.team/config.yaml (team shared)
3. Legacy agenteam.yaml

• If .agenteam.team/config.yaml exists (team project): Use it as the team config. Do not create .agenteam/config.yaml — personal overrides are opt-in. Skip to step 4 (validate).
• If .agenteam/config.yaml or agenteam.yaml exists: Ask the user if they want to reconfigure or keep existing config. If keeping, skip to step 4.
• If absent: Continue to step 3.

3. Create Config

Copy the template:

mkdir -p .agenteam
cp <plugin-dir>/templates/agenteam.yaml.template .agenteam/config.yaml

Default to a fast setup unless the user explicitly asks to customize: