themis-cli 0.1.0__py3-none-any.whl

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/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/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/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/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/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/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/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.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,14 @@
+themis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+themis/cli.py,sha256=c_HdWQBCDESCmXK5YvgMVOT2bSJF0EIBXJ5a0x-XrRQ,492
+themis/config.py,sha256=Q2F-ZlvRaiBRvRNByEqdoYQ744ySlaZ8-xQJy-daK-w,708
+themis/templates.py,sha256=6NMwAc2larbgDx9Io2jl-Hw4UTYUsr11wXIQBw32niE,1688
+themis/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+themis/commands/config.py,sha256=soBZtO5lDhHYi7XhhQzy8Cs6D4u7dsEPZ2Li0GuZ2-8,995
+themis/commands/init_idea.py,sha256=0cNsBY0n_i-dyrH5NxAaZEZ0LVO2KUTJhWJVGYzrMpI,1075
+themis/commands/init_project.py,sha256=GlkFBvLd9by_YJeP0s1cWDLkR7W_N_Y3L9bpJEfIqcM,2679
+themis/commands/list.py,sha256=AFWB4zUqENOvP1gvMQf0AT_4WYBzJIj_LbAWxUgZ27I,861
+themis/commands/promote.py,sha256=3lcUb4DaLlzJanlPJb903EpHOQzRXaG8hu4HvUEXyNk,2225
+themis_cli-0.1.0.dist-info/METADATA,sha256=64IaA8vn4IjlaXA1dIWeZEdGyFlkT_AqEoI4ojbBEg4,2077
+themis_cli-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+themis_cli-0.1.0.dist-info/entry_points.txt,sha256=lc8L8-DisxtChTT_wHXYp6oLJtNhUrcZ2xwD7QEUBzk,43
+themis_cli-0.1.0.dist-info/RECORD,,

themis_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

themis_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+themis = themis.cli:main