A lightweight terminal-based project and task manager.

for the task-tracker challenge from roadmap.sh.

• 📁 Project Management: Add, edit, and delete projects
• ✅ Task Management: Add, edit, delete tasks and update their status (start, complete)
• 🖥 Dual Mode Support:
  • CLI Mode: Manage with command-line arguments
  • Interactive Mode: Use keyboard-driven terminal UI
• 🎨 Theme Support: Switch between light and dark themes in interactive mode

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/wst7/tam/releases/download/latest/tam-installer.sh | sh

powershell -ExecutionPolicy Bypass -c "irm https://github.com/wst7/tam/releases/download/latest/tam-installer.ps1 | iex"

brew install wst7/tap/tam

npm install -g @wst7/tam

To install tam via crates.io:

cargo install tam

To install tam from the GitHub releases

tam -h

A tasks manager cli tool
Version: 1.0.10

Usage: tam [OPTIONS] [COMMAND]

Commands:
  project  Manage projects, use `tam project --help` to see more options [aliases: p]
  task     Manage tasks, use `tam task --help` to see more options [aliases: t]
  config   Show tam configuration
  help     Print this message or the help of the given subcommand(s)

Options:
  -i, --interactive  Interactive mode
  -h, --help         Print help
  -V, --version      Print version

tam -i

A usage skill is bundled in this repository to help AI assistants (Claude Code, Codex, OpenCode, Cursor, etc.) provide accurate tam command guidance.

# Install from GitHub
npx skills add https://github.com/wst7/tam

The tam-usage skill covers:

• Installation methods (Shell, PowerShell, Homebrew, npm, cargo)
• Complete CLI command reference with aliases
• Project / Task management workflow
• Data model and soft-delete conventions
• Common pitfalls (e.g., forgetting tam project use)
• Troubleshooting tips

Once installed, your assistant will automatically load this skill when you ask questions about managing projects or tasks with tam.

Contributions are welcome! Please submit an issue or pull request on the GitHub repository.

tam is licensed under the MIT License.