myteam 0.1.3

Agent roster CLI

Myteam

Simple CLI for managing an on-disk roster of agent roles. Myteam creates a lightweight structure (AGENTS.md plus a .myteam/ directory) that other tools can read to understand available roles and their instructions.

Features

• Zero-dependency CLI (Python 3.11+)
• Commands to create, remove, and inspect roles
• Works from any directory (operates relative to the current working directory)

Requirements

• Python 3.11 or newer

Installation

pip install myteam

Quick start

1. myteam init — set up AGENTS.md and .myteam/ with a default main role (creates .myteam/main/agent.py plus templated info.md/instructions.md).
2. myteam new developer — add another role (optional).
3. Edit .myteam/<role>/info.md and .myteam/<role>/instructions.md with details for each role (new roles start empty; main starts with templates).
4. myteam get-role <role> — run the role’s agent.py (if present) or print instructions.md (defaults to main when omitted).

Commands

Command	Purpose
myteam init	Initialize AGENTS.md and .myteam/ with the default main role (with agent.py, templated info.md and instructions.md).
myteam new <role>	Create a new role directory with agent.py, empty info.md, and instructions.md.
myteam remove <role>	Delete the specified role directory and its contents.
myteam get-role [role]	Print the instructions.md for a role (defaults to main).

What gets created

Running myteam init produces:

AGENTS.md               # Onboarding note for agents
.myteam/
  └── main/
      ├── agent.py        # Prints main instructions plus info.md for other roles
      ├── info.md         # Pre-populated main role metadata template
      └── instructions.md # Pre-populated main role instructions template
  └── <new-role>/        # Created by `myteam new <role>`
      ├── agent.py        # Prints <role>/instructions.md
      ├── info.md         # Empty placeholder
      └── instructions.md # Empty placeholder

Notes and behavior

• Commands act on the current working directory; run them from the root of the project that owns the roster.
• If a role directory contains agent.py, myteam get-role executes it; otherwise it prints instructions.md if present. New roles created with myteam new include an agent.py that prints their instructions.md.
• get-role defaults to the main role if no role name is provided.

Typical workflow

myteam init
echo "Your role instructions here" > .myteam/main/instructions.md
python .myteam/main/agent.py # Prints main instructions plus other role info.md files

Running .myteam/main/agent.py prints main instructions first, then any info.md files found in other role directories under .myteam/.

License

MIT