Metadata-Version: 2.4
Name: themis-cli
Version: 0.2.1
Summary: A CLI tool to manage AI-assisted project workflows
Author-email: Miguel Plazas <devops@miguelplazasr.com>
Requires-Python: >=3.12
Requires-Dist: click>=8.1.0
Requires-Dist: rich>=13.0.0
Description-Content-Type: text/markdown

# 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

```text
~/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 <name>
Creates a new idea in inbox with a structured CLAUDE.md and README.

bash
themis init-idea my-saas-idea
themis init-project <name> [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 <name> [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
