myteam 0.1.0__tar.gz

myteam-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bean Lab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

myteam-0.1.0/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.3
+Name: myteam
+Version: 0.1.0
+Summary: Agent roster CLI
+Author: Unknown
+License: MIT License
+         
+         Copyright (c) 2026 Bean Lab
+         
+         Permission is hereby granted, free of charge, to any person obtaining a copy
+         of this software and associated documentation files (the "Software"), to deal
+         in the Software without restriction, including without limitation the rights
+         to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+         copies of the Software, and to permit persons to whom the Software is
+         furnished to do so, subject to the following conditions:
+         
+         The above copyright notice and this permission notice shall be included in all
+         copies or substantial portions of the Software.
+         
+         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+         SOFTWARE.
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# Myteam
+
+Simple CLI for managing an on-disk roster of agent roles. Myteam creates a lightweight structure (`AGENTS.md` plus a `.agents/` 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
+```bash
+pip install myteam
+```
+
+## Quick start
+1) `myteam init` — set up `AGENTS.md` and `.agents/` with a default `developer` role.
+2) `myteam new main` — add your primary role (defaults to `main` when omitted in `whoami`).
+3) Edit `.agents/<role>/info.md` and `.agents/<role>/instructions.md` with details for each role.
+4) `myteam whoami <role>` — print the instructions for that role (or `main` if omitted).
+
+## Commands
+| Command | Purpose |
+| --- | --- |
+| `myteam init` | Initialize `AGENTS.md` and `.agents/` with the default `developer` role. |
+| `myteam new <role>` | Create a new role directory with empty `info.md` and `instructions.md`. |
+| `myteam remove <role>` | Delete the specified role directory and its contents. |
+| `myteam whoami [role]` | Print the `instructions.md` for a role (defaults to `main`). |
+
+## What gets created
+Running `myteam init` produces:
+
+```
+AGENTS.md               # Onboarding note for agents
+.agents/
+  └── developer/
+      ├── info.md       # Free-form metadata about the role
+      └── instructions.md # The instructions printed by `myteam whoami developer`
+```
+
+## 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 will currently **not execute it**; the CLI only reports that the file exists.
+- `whoami` defaults to the `main` role if no role name is provided.
+
+## Typical workflow
+```bash
+myteam init
+myteam new main
+echo "Your role instructions here" > .agents/main/instructions.md
+myteam whoami main # Run by agent working in project
+```
+
+## License
+MIT

myteam-0.1.0/README.md

@@ -0,0 +1,57 @@
+# Myteam
+
+Simple CLI for managing an on-disk roster of agent roles. Myteam creates a lightweight structure (`AGENTS.md` plus a `.agents/` 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
+```bash
+pip install myteam
+```
+
+## Quick start
+1) `myteam init` — set up `AGENTS.md` and `.agents/` with a default `developer` role.
+2) `myteam new main` — add your primary role (defaults to `main` when omitted in `whoami`).
+3) Edit `.agents/<role>/info.md` and `.agents/<role>/instructions.md` with details for each role.
+4) `myteam whoami <role>` — print the instructions for that role (or `main` if omitted).
+
+## Commands
+| Command | Purpose |
+| --- | --- |
+| `myteam init` | Initialize `AGENTS.md` and `.agents/` with the default `developer` role. |
+| `myteam new <role>` | Create a new role directory with empty `info.md` and `instructions.md`. |
+| `myteam remove <role>` | Delete the specified role directory and its contents. |
+| `myteam whoami [role]` | Print the `instructions.md` for a role (defaults to `main`). |
+
+## What gets created
+Running `myteam init` produces:
+
+```
+AGENTS.md               # Onboarding note for agents
+.agents/
+  └── developer/
+      ├── info.md       # Free-form metadata about the role
+      └── instructions.md # The instructions printed by `myteam whoami developer`
+```
+
+## 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 will currently **not execute it**; the CLI only reports that the file exists.
+- `whoami` defaults to the `main` role if no role name is provided.
+
+## Typical workflow
+```bash
+myteam init
+myteam new main
+echo "Your role instructions here" > .agents/main/instructions.md
+myteam whoami main # Run by agent working in project
+```
+
+## License
+MIT

myteam-0.1.0/pyproject.toml

@@ -0,0 +1,16 @@
+[build-system]
+requires = ["uv-build>=0.2"]
+build-backend = "uv_build"
+
+[project]
+name = "myteam"
+version = "0.1.0"
+description = "Agent roster CLI"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = []
+authors = [{ name = "Unknown" }]
+license = { file = "LICENSE" }
+
+[project.scripts]
+myteam = "myteam.cli:main"

myteam-0.1.0/src/myteam/__init__.py

@@ -0,0 +1,4 @@
+"""Myteam package for managing agent role directories."""
+
+__all__ = ["__version__"]
+__version__ = "0.1.0"

myteam-0.1.0/src/myteam/__main__.py

@@ -0,0 +1,7 @@
+"""Allow `python -m myteam` to run the CLI."""
+
+from .cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

myteam-0.1.0/src/myteam/cli.py

@@ -0,0 +1,147 @@
+"""Command-line interface for the myteam package."""
+from __future__ import annotations
+
+import sys
+import argparse
+import shutil
+from pathlib import Path
+
+from . import __version__
+
+APP_NAME = "myteam"
+DEFAULT_ROLE = "main"
+AGENTS_DIRNAME = ".agents"
+
+
+def _agents_root(base: Path) -> Path:
+    return base / AGENTS_DIRNAME
+
+
+def _role_dir(base: Path, role: str) -> Path:
+    return _agents_root(base) / role
+
+
+def _ensure_dir(path: Path) -> None:
+    path.mkdir(parents=True, exist_ok=True)
+
+
+def cmd_init(base: Path) -> int:
+    """Initialize the myteam directory with default developer role."""
+    agents_dir = _agents_root(base)
+    _ensure_dir(agents_dir)
+
+    # Create AGENTS.md with onboarding instructions.
+    agents_md = base / "AGENTS.md"
+    if not agents_md.exists():
+        agents_md.write_text(
+            "Run `myteam whoami <role>` with your role. If you have no role, assume your role is `main`.\n",
+            encoding="utf-8",
+        )
+
+    # Create default developer role.
+    developer_dir = _role_dir(base, "developer")
+    _ensure_dir(developer_dir)
+
+    (developer_dir / "info.md").touch(exist_ok=True)
+    instructions = developer_dir / "instructions.md"
+    if not instructions.exists():
+        instructions.write_text("Provide developer-specific instructions here.\n", encoding="utf-8")
+
+    return 0
+
+
+def cmd_new(base: Path, role: str) -> int:
+    """Create a new role directory with placeholder files."""
+    role_dir = _role_dir(base, role)
+    if role_dir.exists():
+        print(f"Role '{role}' already exists at {role_dir}", file=sys.stderr)
+        return 1
+
+    _ensure_dir(role_dir)
+    (role_dir / "info.md").write_text("", encoding="utf-8")
+    (role_dir / "instructions.md").write_text("", encoding="utf-8")
+    return 0
+
+
+def cmd_remove(base: Path, role: str) -> int:
+    """Delete the directory for a role if it exists."""
+    role_dir = _role_dir(base, role)
+    if not role_dir.exists():
+        print(f"Role '{role}' not found at {role_dir}", file=sys.stderr)
+        return 1
+
+    if not role_dir.is_dir():
+        print(f"Path for role '{role}' is not a directory: {role_dir}", file=sys.stderr)
+        return 1
+
+    try:
+        shutil.rmtree(role_dir)
+    except OSError as exc:
+        print(f"Failed to remove role '{role}': {exc}", file=sys.stderr)
+        return 1
+
+    return 0
+
+
+def cmd_whoami(base: Path, role: str) -> int:
+    """Print the instructions for the given role if available."""
+    role_dir = _role_dir(base, role)
+    if not role_dir.exists():
+        print(f"Role '{role}' not found. Run 'myteam new {role}' to create it.", file=sys.stderr)
+        return 1
+
+    agent_py = role_dir / "agent.py"
+    if agent_py.exists():
+        # For now, we simply notify; executing arbitrary code is avoided.
+        print(f"agent.py found at {agent_py}; execution not implemented.")
+        return 0
+
+    instructions = role_dir / "instructions.md"
+    if instructions.exists():
+        print(instructions.read_text(encoding="utf-8"))
+        return 0
+
+    print(f"No instructions found for role '{role}'.", file=sys.stderr)
+    return 1
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog=APP_NAME, description="Manage agent roster roles.")
+    parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    sub.add_parser("init", help="Initialize roster with default files.")
+
+    new_parser = sub.add_parser("new", help="Create a new role.")
+    new_parser.add_argument("role", help="Role name to create.")
+
+    remove_parser = sub.add_parser("remove", help="Delete an existing role.")
+    remove_parser.add_argument("role", help="Role name to delete.")
+
+    who_parser = sub.add_parser("whoami", help="Print instructions for a role.")
+    who_parser.add_argument("role", nargs="?", default=DEFAULT_ROLE, help="Role name (default: main).")
+
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    argv = sys.argv[1:] if argv is None else argv
+    base = Path.cwd()
+    parser = build_parser()
+    args = parser.parse_args(argv)
+
+    if args.command == "init":
+        return cmd_init(base)
+    if args.command == "new":
+        return cmd_new(base, args.role)
+    if args.command == "remove":
+        return cmd_remove(base, args.role)
+    if args.command == "whoami":
+        return cmd_whoami(base, args.role)
+
+    parser.error("Unknown command")
+    return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())