team - Team Coordination CLI
Manage team members and messages for your Codev project. Team data is stored in codev/team/ and displayed in the Tower dashboard.
Synopsis
team list
team message <text> [-a <author>]
team update
team add <github-handle> [-n <name>] [-r <role>]
Commands
team list
List all team members from codev/team/people/.
team list
Displays a formatted table with Name, GitHub handle, and Role columns.
team message <text>
Post a message to the team message log (codev/team/messages.md).
team message "Spec 42 is ready for review"
team message "Deployed to staging" -a deploy-bot
Options:
-a, --author <name> — Override author (default: auto-detected from gh CLI or git config)
team update
Post an hourly activity summary. Called automatically by cron (.af-cron/team-update.yaml) or manually.
team update
Collects notable events from the last hour (builder spawns, gate approvals, PR merges, completed reviews) and posts a summary. Exits silently if no events occurred.
team add <github-handle>
Scaffold a new team member file.
team add waleedkadous
team add jdoe --name "Jane Doe" --role "Developer"
Options:
-n, --name <name> — Full name (default: github handle)-r, --role <role> — Role (default: "Team Member")
Creates codev/team/people/<handle>.md with YAML frontmatter. Handle is normalized to lowercase. Fails if the member already exists.
Team Directory Structure
codev/team/
├── people/
│ ├── waleedkadous.md # YAML frontmatter + optional bio
│ └── jdoe.md
└── messages.md # Append-only message log
Team Member File Format
---
name: M Waleed Kadous
github: waleedkadous
role: Lead Architect
---
Optional freeform bio or notes (not displayed in Tower).
Required frontmatter fields:
name — Display namegithub — GitHub handle (used for API data enrichment)role — Team role (displayed in Tower)
Message Log Format
# Team Messages
<!-- Append new messages below. Do not edit or delete existing entries. -->
---
**waleedkadous** | 2026-03-09 14:30 UTC
Spec 42 is ready for review.
---
**tower-cron** | 2026-03-09 15:00 UTC
Hourly update: Merged PR #123: Add user auth. Gate approved for #42.
Messages are append-only. Each entry has an author, UTC timestamp, and body text.
Deprecation Note
afx team commands still work but print a deprecation warning. Use team directly:
afx team list → team listafx team message → team messageafx team update → team update
Setup
To set up a team directory for a new project:
team add first-member --name "First Member" --role "Architect"
team add second-member --name "Second Member" --role "Developer"
The Team tab appears in Tower when 2+ valid members exist.