themis-cli 0.1.0__tar.gz

themis_cli-0.1.0/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: themis-cli
+Version: 0.1.0
+Summary: A CLI tool to manage AI-assisted project workflows
+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

themis_cli-0.1.0/README.md

@@ -0,0 +1,72 @@
+# 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

themis_cli-0.1.0/pyproject.toml

@@ -0,0 +1,20 @@
+[project]
+name = "themis-cli"
+version = "0.1.0"
+description = "A CLI tool to manage AI-assisted project workflows"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "click>=8.1.0",
+    "rich>=13.0.0",
+]
+
+[project.scripts]
+themis = "themis.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/themis"]

themis_cli-0.1.0/src/themis/cli.py

@@ -0,0 +1,19 @@
+import click
+from themis.commands.init_idea import init_idea
+from themis.commands.init_project import init_project
+from themis.commands.promote import promote
+from themis.commands.list import list_all
+from themis.commands.config import config
+
+
+@click.group()
+def main():
+    """Themis — AI-assisted project workflow manager."""
+    pass
+
+
+main.add_command(init_idea)
+main.add_command(init_project)
+main.add_command(promote)
+main.add_command(list_all, name="list")
+main.add_command(config)

themis_cli-0.1.0/src/themis/commands/config.py

@@ -0,0 +1,40 @@
+import click
+from rich.console import Console
+from themis.config import load_config, save_config, get_workspace
+
+console = Console()
+
+
+@click.group()
+def config():
+    """Manage Themis configuration."""
+    pass
+
+
+@config.command()
+@click.argument("key")
+@click.argument("value")
+def set(key: str, value: str):
+    """Set a configuration value."""
+    allowed = ["workspace"]
+    if key not in allowed:
+        console.print(f"[red]❌ Unknown key:[/red] {key}")
+        console.print(f"Allowed keys: {', '.join(allowed)}")
+        raise SystemExit(1)
+
+    data = load_config()
+    data[key] = value
+    save_config(data)
+    console.print(f"[green]✅ {key}[/green] → {value}")
+
+
+@config.command()
+@click.argument("key")
+def get(key: str):
+    """Get a configuration value."""
+    data = load_config()
+    value = data.get(key)
+    if not value:
+        console.print(f"[dim]{key} is not set. Default: {get_workspace()}[/dim]")
+        return
+    console.print(f"{key}: [bold]{value}[/bold]")

themis_cli-0.1.0/src/themis/commands/init_idea.py

@@ -0,0 +1,34 @@
+import click
+from rich.console import Console
+from themis.config import INBOX_DIR
+from themis.templates import (
+    render_inbox_claude,
+    render_inbox_readme,
+    render_decision_template,
+)
+
+console = Console()
+
+
+@click.command()
+@click.argument("name")
+def init_idea(name: str):
+    """Create a new idea in inbox."""
+    idea_dir = INBOX_DIR / name
+
+    if idea_dir.exists():
+        console.print(f"[red]❌ Idea already exists:[/red] {idea_dir}")
+        raise SystemExit(1)
+
+    decisions_dir = idea_dir / "decisions"
+    decisions_dir.mkdir(parents=True)
+
+    (idea_dir / "CLAUDE.md").write_text(render_inbox_claude(name))
+    (idea_dir / "README.md").write_text(render_inbox_readme(name))
+    (decisions_dir / "000-template.md").write_text(render_decision_template())
+
+    console.print(f"[green]✅ Idea created:[/green] {idea_dir}")
+    console.print("\nNext steps:")
+    console.print("  1. Open CLAUDE.md and define the problem")
+    console.print("  2. Start researching with Claude")
+    console.print(f"  3. When ready: [bold]themis promote {name}[/bold]")

themis_cli-0.1.0/src/themis/commands/init_project.py

@@ -0,0 +1,83 @@
+import click
+import subprocess
+from rich.console import Console
+from themis.config import PROJECTS_DIR, STACKS
+from themis.templates import render_project_claude, render_decision_template
+
+console = Console()
+
+
+def scaffold_stack(stack: str, project_dir):
+    """Run native tooling for the given stack."""
+    name = project_dir.name
+    parent = project_dir.parent
+
+    if stack == "python":
+        subprocess.run(["uv", "init", name], cwd=parent, check=True)
+    elif stack == "nextjs":
+        subprocess.run(
+            ["pnpm", "create", "next-app", name],
+            cwd=parent,
+            check=True,
+        )
+    elif stack == "angular":
+        subprocess.run(["ng", "new", name], cwd=parent, check=True)
+    elif stack == "node":
+        project_dir.mkdir(parents=True)
+        subprocess.run(["pnpm", "init"], cwd=project_dir, check=True)
+
+
+def add_project_files(project_dir, stack: str, research_notes: str = ""):
+    """Add CLAUDE.md and docs/ to an existing project directory."""
+    docs_decisions = project_dir / "docs" / "decisions"
+    docs_decisions.mkdir(parents=True, exist_ok=True)
+
+    (project_dir / "CLAUDE.md").write_text(
+        render_project_claude(project_dir.name, stack, research_notes)
+    )
+    (docs_decisions / "000-template.md").write_text(render_decision_template())
+
+    gitignore = project_dir / ".gitignore"
+    if not gitignore.exists():
+        gitignore.write_text(".env\n.env.*\n.DS_Store\n")
+
+
+def init_git(project_dir):
+    """Initialize git repo and make first commit."""
+    subprocess.run(["git", "init", "-b", "main"], cwd=project_dir, check=True)
+    subprocess.run(["git", "add", "-A"], cwd=project_dir, check=True)
+    subprocess.run(
+        ["git", "commit", "-m", "chore: init project"],
+        cwd=project_dir,
+        check=True,
+    )
+
+
+@click.command()
+@click.argument("name")
+@click.argument("stack", required=False)
+def init_project(name: str, stack: str):
+    """Create a new project."""
+    if not stack:
+        stack = click.prompt(
+            "Stack",
+            type=click.Choice(STACKS),
+            show_choices=True,
+        )
+
+    project_dir = PROJECTS_DIR / name
+
+    if project_dir.exists():
+        console.print(f"[red]❌ Project already exists:[/red] {project_dir}")
+        raise SystemExit(1)
+
+    PROJECTS_DIR.mkdir(parents=True, exist_ok=True)
+
+    console.print(f"[bold]🚀 Initializing project:[/bold] {name} ({stack})")
+
+    scaffold_stack(stack, project_dir)
+    add_project_files(project_dir, stack)
+    init_git(project_dir)
+
+    console.print(f"\n[green]✅ Project ready:[/green] {project_dir}")
+    console.print(f"\nNext: [bold]cd {project_dir}[/bold] and open Claude Code")

themis_cli-0.1.0/src/themis/commands/list.py

@@ -0,0 +1,35 @@
+import click
+from rich.console import Console
+from rich.table import Table
+from themis.config import INBOX_DIR, PROJECTS_DIR
+
+console = Console()
+
+
+def get_subdirs(path):
+    if not path.exists():
+        return []
+    return sorted([d.name for d in path.iterdir() if d.is_dir()])
+
+
+@click.command()
+def list_all():
+    """List all ideas and projects."""
+    ideas = get_subdirs(INBOX_DIR)
+    projects = get_subdirs(PROJECTS_DIR)
+
+    if not ideas and not projects:
+        console.print("[dim]No ideas or projects found.[/dim]")
+        return
+
+    table = Table(title="Themis Workspace", show_lines=True)
+    table.add_column("Type", style="dim")
+    table.add_column("Name", style="bold")
+
+    for idea in ideas:
+        table.add_row("💡 idea", idea)
+
+    for project in projects:
+        table.add_row("🚀 project", project)
+
+    console.print(table)

themis_cli-0.1.0/src/themis/commands/promote.py

@@ -0,0 +1,75 @@
+import click
+import shutil
+from rich.console import Console
+from themis.config import INBOX_DIR, PROJECTS_DIR, STACKS
+from themis.commands.init_project import scaffold_stack, add_project_files, init_git
+
+console = Console()
+
+
+def extract_research_notes(claude_md_path) -> str:
+    """Extract full content of inbox CLAUDE.md to use as research notes."""
+    if not claude_md_path.exists():
+        return ""
+    return claude_md_path.read_text()
+
+
+def migrate_decisions(inbox_dir, project_dir):
+    """Copy decisions from inbox to project docs/decisions/."""
+    src = inbox_dir / "decisions"
+    dst = project_dir / "docs" / "decisions"
+
+    if not src.exists():
+        return
+
+    for f in src.iterdir():
+        if f.name == "000-template.md":
+            continue
+        dest_file = dst / f.name
+        shutil.copy2(f, dest_file)
+        console.print(f"  [dim]Migrated:[/dim] {f.name}")
+
+
+@click.command()
+@click.argument("name")
+@click.argument("stack", required=False)
+def promote(name: str, stack: str):
+    """Promote an idea from inbox to a full project."""
+    idea_dir = INBOX_DIR / name
+
+    if not idea_dir.exists():
+        console.print(f"[red]❌ Idea not found:[/red] {idea_dir}")
+        raise SystemExit(1)
+
+    if not stack:
+        stack = click.prompt(
+            "Stack",
+            type=click.Choice(STACKS),
+            show_choices=True,
+        )
+
+    project_dir = PROJECTS_DIR / name
+
+    if project_dir.exists():
+        console.print(f"[red]❌ Project already exists:[/red] {project_dir}")
+        raise SystemExit(1)
+
+    PROJECTS_DIR.mkdir(parents=True, exist_ok=True)
+
+    console.print(f"[bold]🚀 Promoting:[/bold] {name} → projects/ ({stack})")
+
+    research_notes = extract_research_notes(idea_dir / "CLAUDE.md")
+
+    scaffold_stack(stack, project_dir)
+    add_project_files(project_dir, stack, research_notes)
+
+    console.print("\n[dim]Migrating decisions...[/dim]")
+    migrate_decisions(idea_dir, project_dir)
+
+    init_git(project_dir)
+
+    shutil.rmtree(idea_dir)
+    console.print(f"[dim]Removed inbox/{name}[/dim]")
+
+    console.print(f"\n[green]✅ Project ready:[/green] {project_dir}")
+    console.print(f"\nNext: [bold]cd {project_dir}[/bold] and open Claude Code")

themis_cli-0.1.0/src/themis/config.py

@@ -0,0 +1,30 @@
+import json
+from pathlib import Path
+
+CONFIG_DIR = Path.home() / ".config" / "themis"
+CONFIG_FILE = CONFIG_DIR / "config.json"
+
+DEFAULT_WORKSPACE = Path.home() / "themis-workspace"
+
+
+def load_config() -> dict:
+    if not CONFIG_FILE.exists():
+        return {}
+    return json.loads(CONFIG_FILE.read_text())
+
+
+def save_config(data: dict):
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    CONFIG_FILE.write_text(json.dumps(data, indent=2))
+
+
+def get_workspace() -> Path:
+    config = load_config()
+    return Path(config.get("workspace", DEFAULT_WORKSPACE))
+
+
+BASE_DIR = get_workspace()
+INBOX_DIR = BASE_DIR / "inbox"
+PROJECTS_DIR = BASE_DIR / "projects"
+
+STACKS = ["python", "angular", "nextjs", "node"]

themis_cli-0.1.0/src/themis/templates.py

@@ -0,0 +1,83 @@
+def render_inbox_claude(name: str) -> str:
+    return f"""# Idea: {name}
+
+## Problem
+(What problem are you trying to solve?)
+
+## Hypothesis
+(What's your proposed solution?)
+
+## Open Questions
+(What do you still need to figure out?)
+
+## Context
+(Relevant notes from research)
+"""
+
+
+def render_inbox_readme(name: str) -> str:
+    return f"""# {name}
+
+## Problem
+(What real problem does this project solve?)
+
+## Target Audience
+(Who is this for?)
+
+## MVP Scope
+(What is the smallest thing that can validate the idea?)
+
+## Out of Scope
+(What will NOT be built yet?)
+
+## Success Criteria
+(How do we know this is working?)
+"""
+
+
+def render_project_claude(name: str, stack: str, research_notes: str = "") -> str:
+    notes_section = ""
+    if research_notes:
+        notes_section = f"\n## Research Notes\n{research_notes}\n"
+
+    return f"""# {name}
+
+## Stack
+- Type: {stack}
+- (add frameworks, DB, etc.)
+
+## Conventions
+- Commits in English: feat / fix / chore / docs
+- Tests required for business logic
+- Important decisions → docs/decisions/
+
+## Rules
+- Do not implement without understanding the problem first
+- Prefer simple and reversible solutions
+- Ask before assuming if context is missing
+- Explain trade-offs when more than one valid option exists
+
+## Current Status
+- Stage: MVP
+- Last updated: (update this)
+{notes_section}"""
+
+
+def render_decision_template() -> str:
+    return """# 000 - Decision Title
+
+**Date:** YYYY-MM-DD
+**Status:** Proposed | Accepted | Rejected
+
+## Context
+(What situation led to this decision?)
+
+## Decision
+(What did we decide?)
+
+## Alternatives Considered
+(What other options were evaluated?)
+
+## Trade-offs
+(What do we gain and what do we lose?)
+"""

themis_cli-0.1.0/uv.lock

@@ -0,0 +1,82 @@
+version = 1
+revision = 3
+requires-python = ">=3.12"
+
+[[package]]
+name = "click"
+version = "8.3.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/57/75/31212c6bf2503fdf920d87fee5d7a86a2e3bcf444984126f13d8e4016804/click-8.3.2.tar.gz", hash = "sha256:14162b8b3b3550a7d479eafa77dfd3c38d9dc8951f6f69c78913a8f9a7540fd5", size = 302856, upload-time = "2026-04-03T19:14:45.118Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e4/20/71885d8b97d4f3dde17b1fdb92dbd4908b00541c5a3379787137285f602e/click-8.3.2-py3-none-any.whl", hash = "sha256:1924d2c27c5653561cd2cae4548d1406039cb79b858b747cfea24924bbc1616d", size = 108379, upload-time = "2026-04-03T19:14:43.505Z" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "markdown-it-py"
+version = "4.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "mdurl" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/5b/f5/4ec618ed16cc4f8fb3b701563655a69816155e79e24a17b651541804721d/markdown_it_py-4.0.0.tar.gz", hash = "sha256:cb0a2b4aa34f932c007117b194e945bd74e0ec24133ceb5bac59009cda1cb9f3", size = 73070, upload-time = "2025-08-11T12:57:52.854Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/94/54/e7d793b573f298e1c9013b8c4dade17d481164aa517d1d7148619c2cedbf/markdown_it_py-4.0.0-py3-none-any.whl", hash = "sha256:87327c59b172c5011896038353a81343b6754500a08cd7a4973bb48c6d578147", size = 87321, upload-time = "2025-08-11T12:57:51.923Z" },
+]
+
+[[package]]
+name = "mdurl"
+version = "0.1.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d6/54/cfe61301667036ec958cb99bd3efefba235e65cdeb9c84d24a8293ba1d90/mdurl-0.1.2.tar.gz", hash = "sha256:bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba", size = 8729, upload-time = "2022-08-14T12:40:10.846Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/38/89ba8ad64ae25be8de66a6d463314cf1eb366222074cfda9ee839c56a4b4/mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8", size = 9979, upload-time = "2022-08-14T12:40:09.779Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.20.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c3/b2/bc9c9196916376152d655522fdcebac55e66de6603a76a02bca1b6414f6c/pygments-2.20.0.tar.gz", hash = "sha256:6757cd03768053ff99f3039c1a36d6c0aa0b263438fcab17520b30a303a82b5f", size = 4955991, upload-time = "2026-03-29T13:29:33.898Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/7e/a72dd26f3b0f4f2bf1dd8923c85f7ceb43172af56d63c7383eb62b332364/pygments-2.20.0-py3-none-any.whl", hash = "sha256:81a9e26dd42fd28a23a2d169d86d7ac03b46e2f8b59ed4698fb4785f946d0176", size = 1231151, upload-time = "2026-03-29T13:29:30.038Z" },
+]
+
+[[package]]
+name = "rich"
+version = "15.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "markdown-it-py" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/c0/8f/0722ca900cc807c13a6a0c696dacf35430f72e0ec571c4275d2371fca3e9/rich-15.0.0.tar.gz", hash = "sha256:edd07a4824c6b40189fb7ac9bc4c52536e9780fbbfbddf6f1e2502c31b068c36", size = 230680, upload-time = "2026-04-12T08:24:00.75Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/82/3b/64d4899d73f91ba49a8c18a8ff3f0ea8f1c1d75481760df8c68ef5235bf5/rich-15.0.0-py3-none-any.whl", hash = "sha256:33bd4ef74232fb73fe9279a257718407f169c09b78a87ad3d296f548e27de0bb", size = 310654, upload-time = "2026-04-12T08:24:02.83Z" },
+]
+
+[[package]]
+name = "themis"
+version = "0.1.0"
+source = { editable = "." }
+dependencies = [
+    { name = "click" },
+    { name = "rich" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "click", specifier = ">=8.1.0" },
+    { name = "rich", specifier = ">=13.0.0" },
+]