Skip to content

Evaluate and set up CLI framework (Typer/Click/argparse) #27

@Aureliolo

Description

@Aureliolo

Context

Choose the CLI framework for the ai-company command-line interface. The CLI is the primary human interaction surface for managing companies, agents, and tasks.

Options under consideration:

  • Typer — Modern, type-hint driven, auto-completion support, built on Click
  • Click — Mature, widely adopted, explicit decorators
  • argparse — Standard library, no dependencies, verbose

A terminal output library must also be chosen (e.g., Rich for tables, colors, progress bars).

Acceptance Criteria

  • CLI framework evaluated and chosen with documented rationale
  • Framework installed and added to project dependencies
  • Basic CLI skeleton created with --help and --version flags
  • Entry point configured in pyproject.toml (ai-company command)
  • Rich (or equivalent) terminal output library chosen and installed
  • Decision documented (ADR or design doc)
  • Basic smoke test verifying CLI entry point works

Dependencies

  • None (can start independently)

Design Spec Reference

  • Spec 15.2 — CLI interface requirements

Metadata

Metadata

Assignees

No one assigned

    Labels

    prio:highImportant, should be prioritizedscope:smallLess than 1 day of workspec:human-interactionDESIGN_SPEC Section 13 - Human Interaction Layertype:featureNew feature implementationtype:researchEvaluate options, make tech decisions

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions