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 name
• github — 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 list
• afx team message → team message
• afx 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.