themis-cli 0.2.0

A CLI tool to manage AI-assisted project workflows

Themis

A CLI tool to manage AI-assisted project workflows.

Themis helps you structure the full lifecycle of a project — from the initial idea and research phase through to a fully initialized, version-controlled codebase — keeping all context, decisions, and documentation in one place.

Why Themis?

When working with AI assistants like Claude, valuable research and architectural decisions often get lost in chat history. Themis solves this by giving every idea and project a structured home where context is preserved and travels with the code.

Workspace Structure

~/themis/ai-workspace/
├── inbox/         # Ideas under exploration
└── projects/      # Active projects

Installation Requires Python 3.12+ and uv.

bash git clone https://github.com/youruser/themis.git cd themis uv tool install . Commands themis init-idea Creates a new idea in inbox with a structured CLAUDE.md and README.

bash themis init-idea my-saas-idea themis init-project [stack] Creates a fully initialized project with native tooling, CLAUDE.md, and Git.

Supported stacks: python, angular, nextjs, node

bash themis init-project my-project python

or let Themis ask you

themis init-project my-project themis promote [stack] Promotes an idea from inbox to a full project, migrating decisions and research context automatically. Removes the idea from inbox after migration.

bash themis promote my-saas-idea python themis list Lists all ideas and projects in your workspace.

bash themis list Workflow text

1. Got an idea? themis init-idea my-idea

2. Research and explore with Claude. Document decisions in inbox/my-idea/decisions/

3. Ready to build? themis promote my-idea python

4. Open your project and start building. cd ~/themis/ai-workspace/projects/my-idea claude License MIT