cleanvibe 0.1.2__tar.gz

cleanvibe-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Immanuelle
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cleanvibe-0.1.2/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: cleanvibe
+Version: 0.1.2
+Summary: A workflow accelerator that scaffolds AI-assisted coding projects with opinionated documentation and launches Claude Code.
+Author: Immanuelle
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Immanuelle/cleanvibe
+Project-URL: Issues, https://github.com/Immanuelle/cleanvibe/issues
+Keywords: claude,ai,scaffold,workflow,vibe-coding
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# cleanvibe
+
+A tiny Python CLI that scaffolds AI-assisted coding projects and launches Claude Code.
+
+`cleanvibe` is not a coding tool. It's a **state initializer** -- it removes the friction between "I want to build something" and "Claude is working inside a well-structured environment." The real value lives in the `CLAUDE.md` it injects: an opinionated behavior contract that enforces documentation discipline, meaningful commits, and iterative file-based thinking.
+
+## Install
+
+```
+pip install cleanvibe
+```
+
+## Usage
+
+### Create a new project
+
+```
+cleanvibe new my-project
+```
+
+This will:
+1. Create the directory `my-project/`
+2. Write `CLAUDE.md` (workflow rules for AI-assisted development)
+3. Write `README.md` (starter documentation)
+4. Write `.gitignore` (sensible Python defaults)
+5. Initialize a git repo with an initial commit
+6. Launch Claude Code inside the project
+
+### Clone an existing repo
+
+```
+cleanvibe clone https://github.com/user/repo
+```
+
+This will:
+1. `git clone` the repository
+2. Check for missing `CLAUDE.md`, `README.md`, `.gitignore`
+3. Inject any missing files without overwriting existing ones
+4. Launch Claude Code inside the project
+
+### Options
+
+```
+cleanvibe new my-project --dry-run     # Preview what would be created
+cleanvibe new my-project --no-claude   # Skip launching Claude Code
+cleanvibe clone REPO path --dry-run    # Preview what would be done
+cleanvibe --version                    # Show version
+```
+
+## Why?
+
+Most people struggle with blank repo paralysis, poor commit hygiene, and AI assistants that ramble without producing durable artifacts. `cleanvibe` solves this by injecting a disciplined thinking contract into every project from the start.
+
+The `CLAUDE.md` template enforces:
+- Commit early and often with meaningful messages
+- No planning-only modes -- all thinking produces files and commits
+- Keep documentation up to date as the project evolves
+- Use `planning/` directories for exploration instead of internal planning modes
+
+## Cross-platform
+
+Works on Windows, Linux, and macOS. Zero dependencies beyond Python 3.9+.
+
+## License
+
+MIT

cleanvibe-0.1.2/README.md

@@ -0,0 +1,66 @@
+# cleanvibe
+
+A tiny Python CLI that scaffolds AI-assisted coding projects and launches Claude Code.
+
+`cleanvibe` is not a coding tool. It's a **state initializer** -- it removes the friction between "I want to build something" and "Claude is working inside a well-structured environment." The real value lives in the `CLAUDE.md` it injects: an opinionated behavior contract that enforces documentation discipline, meaningful commits, and iterative file-based thinking.
+
+## Install
+
+```
+pip install cleanvibe
+```
+
+## Usage
+
+### Create a new project
+
+```
+cleanvibe new my-project
+```
+
+This will:
+1. Create the directory `my-project/`
+2. Write `CLAUDE.md` (workflow rules for AI-assisted development)
+3. Write `README.md` (starter documentation)
+4. Write `.gitignore` (sensible Python defaults)
+5. Initialize a git repo with an initial commit
+6. Launch Claude Code inside the project
+
+### Clone an existing repo
+
+```
+cleanvibe clone https://github.com/user/repo
+```
+
+This will:
+1. `git clone` the repository
+2. Check for missing `CLAUDE.md`, `README.md`, `.gitignore`
+3. Inject any missing files without overwriting existing ones
+4. Launch Claude Code inside the project
+
+### Options
+
+```
+cleanvibe new my-project --dry-run     # Preview what would be created
+cleanvibe new my-project --no-claude   # Skip launching Claude Code
+cleanvibe clone REPO path --dry-run    # Preview what would be done
+cleanvibe --version                    # Show version
+```
+
+## Why?
+
+Most people struggle with blank repo paralysis, poor commit hygiene, and AI assistants that ramble without producing durable artifacts. `cleanvibe` solves this by injecting a disciplined thinking contract into every project from the start.
+
+The `CLAUDE.md` template enforces:
+- Commit early and often with meaningful messages
+- No planning-only modes -- all thinking produces files and commits
+- Keep documentation up to date as the project evolves
+- Use `planning/` directories for exploration instead of internal planning modes
+
+## Cross-platform
+
+Works on Windows, Linux, and macOS. Zero dependencies beyond Python 3.9+.
+
+## License
+
+MIT

cleanvibe-0.1.2/cleanvibe/__init__.py

@@ -0,0 +1,3 @@
+"""cleanvibe - scaffold AI-assisted coding projects and launch Claude Code."""
+
+__version__ = "0.1.2"

cleanvibe-0.1.2/cleanvibe/cli.py

@@ -0,0 +1,82 @@
+"""Command-line interface for cleanvibe.
+
+Usage:
+    cleanvibe new PATH          Create a new scaffolded project
+    cleanvibe clone REPO [PATH] Clone a repo and inject scaffolding
+    cleanvibe --version         Show version
+
+Zero dependencies. Just Python stdlib.
+"""
+
+import argparse
+import sys
+from pathlib import Path
+
+from . import __version__
+from .scaffold import clone_project, create_project
+
+
+def main(argv: list[str] | None = None) -> None:
+    parser = argparse.ArgumentParser(
+        prog="cleanvibe",
+        description="Scaffold AI-assisted coding projects and launch Claude Code.",
+    )
+    parser.add_argument(
+        "--version", action="version", version=f"cleanvibe {__version__}"
+    )
+
+    subparsers = parser.add_subparsers(dest="command")
+
+    # cleanvibe new PATH
+    new_parser = subparsers.add_parser(
+        "new", help="Create a new project with opinionated scaffolding"
+    )
+    new_parser.add_argument("path", type=Path, help="Directory to create")
+    new_parser.add_argument(
+        "--dry-run", action="store_true", help="Show what would be created without writing anything"
+    )
+    new_parser.add_argument(
+        "--no-claude", action="store_true", help="Skip launching Claude Code after scaffolding"
+    )
+
+    # cleanvibe clone REPO [PATH]
+    clone_parser = subparsers.add_parser(
+        "clone", help="Clone a repo and inject missing scaffolding"
+    )
+    clone_parser.add_argument("repo", help="Git repository URL to clone")
+    clone_parser.add_argument(
+        "path", nargs="?", type=Path, default=None, help="Target directory (defaults to repo name)"
+    )
+    clone_parser.add_argument(
+        "--dry-run", action="store_true", help="Show what would be done without writing anything"
+    )
+    clone_parser.add_argument(
+        "--no-claude", action="store_true", help="Skip launching Claude Code after cloning"
+    )
+
+    args = parser.parse_args(argv)
+
+    if args.command is None:
+        parser.print_help()
+        sys.exit(0)
+
+    if args.command == "new":
+        if args.path.exists() and any(args.path.iterdir()):
+            print(f"Error: {args.path} already exists and is not empty.", file=sys.stderr)
+            sys.exit(1)
+        print(f"Creating project: {args.path}")
+        create_project(args.path, dry_run=args.dry_run, no_claude=args.no_claude)
+
+    elif args.command == "clone":
+        if args.path is None:
+            # Derive directory name from repo URL
+            repo_name = args.repo.rstrip("/").rsplit("/", 1)[-1]
+            if repo_name.endswith(".git"):
+                repo_name = repo_name[:-4]
+            args.path = Path(repo_name)
+        print(f"Cloning {args.repo} -> {args.path}")
+        clone_project(args.repo, args.path, dry_run=args.dry_run, no_claude=args.no_claude)
+
+
+if __name__ == "__main__":
+    main()

cleanvibe-0.1.2/cleanvibe/scaffold.py

@@ -0,0 +1,116 @@
+"""Core scaffolding logic for cleanvibe.
+
+Creates project directories, writes template files, initializes git,
+and launches Claude Code.
+"""
+
+import os
+import platform
+import subprocess
+import sys
+from pathlib import Path
+
+from . import templates
+
+
+def create_project(path: Path, dry_run: bool = False, no_claude: bool = False) -> None:
+    """Create a new project directory with opinionated scaffolding."""
+    project_name = path.name
+
+    if dry_run:
+        print(f"[dry-run] Would create directory: {path}")
+        print(f"[dry-run] Would write: {path / 'CLAUDE.md'}")
+        print(f"[dry-run] Would write: {path / 'README.md'}")
+        print(f"[dry-run] Would write: {path / '.gitignore'}")
+        print(f"[dry-run] Would run: git init")
+        print(f"[dry-run] Would run: git add . && git commit")
+        if not no_claude:
+            print(f"[dry-run] Would launch: claude")
+        return
+
+    path.mkdir(parents=True, exist_ok=True)
+
+    _write(path / "CLAUDE.md", templates.claude_md(project_name))
+    _write(path / "README.md", templates.readme_md(project_name))
+    _write(path / ".gitignore", templates.GITIGNORE)
+
+    _git_init(path)
+
+    if not no_claude:
+        _launch_claude(path)
+
+
+def clone_project(repo: str, path: Path, dry_run: bool = False, no_claude: bool = False) -> None:
+    """Clone a repo and inject scaffolding if missing."""
+    if dry_run:
+        print(f"[dry-run] Would run: git clone {repo} {path}")
+        print(f"[dry-run] Would check for missing CLAUDE.md / README.md / .gitignore")
+        print(f"[dry-run] Would inject any missing files")
+        if not no_claude:
+            print(f"[dry-run] Would launch: claude")
+        return
+
+    result = subprocess.run(["git", "clone", repo, str(path)])
+    if result.returncode != 0:
+        print(f"Error: git clone failed with exit code {result.returncode}", file=sys.stderr)
+        sys.exit(1)
+
+    project_name = path.name
+
+    # Only inject files that are missing - don't overwrite existing ones
+    claude_md = path / "CLAUDE.md"
+    if not claude_md.exists():
+        _write(claude_md, templates.claude_md(project_name))
+        print(f"  Injected CLAUDE.md (was missing)")
+
+    readme = path / "README.md"
+    if not readme.exists():
+        _write(readme, templates.readme_md(project_name))
+        print(f"  Injected README.md (was missing)")
+
+    gitignore = path / ".gitignore"
+    if not gitignore.exists():
+        _write(gitignore, templates.GITIGNORE)
+        print(f"  Injected .gitignore (was missing)")
+
+    if not no_claude:
+        _launch_claude(path)
+
+
+def _write(filepath: Path, content: str) -> None:
+    filepath.write_text(content, encoding="utf-8")
+    print(f"  Created {filepath.name}")
+
+
+def _git_init(path: Path) -> None:
+    subprocess.run(["git", "init"], cwd=path, capture_output=True)
+    subprocess.run(["git", "add", "."], cwd=path, capture_output=True)
+    subprocess.run(
+        ["git", "commit", "-m", "Initial commit: cleanvibe scaffold"],
+        cwd=path,
+        capture_output=True,
+    )
+    print(f"  Initialized git repo with initial commit")
+
+
+def _launch_claude(path: Path) -> None:
+    """Launch Claude Code in the project directory.
+
+    On Windows, opens a new cmd window. On Unix, replaces the current process.
+    """
+    print(f"  Launching Claude Code...")
+    system = platform.system()
+    try:
+        if system == "Windows":
+            subprocess.Popen(
+                ["cmd", "/k", f'cd /d "{path}" && claude'],
+                creationflags=subprocess.CREATE_NEW_CONSOLE,
+            )
+        else:
+            os.chdir(path)
+            os.execlp("claude", "claude")
+    except FileNotFoundError:
+        print(
+            "  Could not launch 'claude'. Make sure Claude Code is installed and on your PATH.",
+            file=sys.stderr,
+        )

cleanvibe-0.1.2/cleanvibe/templates.py

@@ -0,0 +1,80 @@
+"""Default templates that cleanvibe injects into new projects.
+
+The CLAUDE.md template is the core of cleanvibe. It shapes how Claude Code
+behaves inside a repo by enforcing documentation discipline, meaningful commits,
+and iterative file-based thinking over planning-only modes.
+"""
+
+from datetime import datetime
+
+
+def claude_md(project_name: str) -> str:
+    date = datetime.now().strftime("%Y-%m-%d")
+    return f"""# {project_name}
+
+## Workflow Rules
+- **Commit early and often.** Every meaningful change gets a commit with a clear message explaining *why*, not just what.
+- **Do not enter planning-only modes.** All thinking must produce files and commits. If scope is unclear, create a `planning/` directory and write `.md` files there instead of using an internal planning mode.
+- **Keep this file up to date.** As the project takes shape, record architectural decisions, conventions, and anything needed to work effectively in this repo.
+- **Update README.md regularly.** It should always reflect the current state of the project for human readers.
+
+## Project Description
+_TODO: Describe what this project is about._
+
+## Architecture and Conventions
+_TODO: Document key decisions, file structure, and patterns as they emerge._
+
+# currentDate
+Today's date is {date}.
+"""
+
+
+def readme_md(project_name: str) -> str:
+    return f"""# {project_name}
+
+> Scaffolded with [cleanvibe](https://github.com/Immanuelle/cleanvibe).
+
+## About
+
+_TODO: Describe what this project does._
+
+## Getting Started
+
+This project was initialized with `cleanvibe new` and is intended to be developed
+with AI-assisted coding via Claude Code.
+
+```
+cd {project_name}
+claude
+```
+"""
+
+
+GITIGNORE = """# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+*.egg
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.local
+"""

cleanvibe-0.1.2/cleanvibe.egg-info/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: cleanvibe
+Version: 0.1.2
+Summary: A workflow accelerator that scaffolds AI-assisted coding projects with opinionated documentation and launches Claude Code.
+Author: Immanuelle
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Immanuelle/cleanvibe
+Project-URL: Issues, https://github.com/Immanuelle/cleanvibe/issues
+Keywords: claude,ai,scaffold,workflow,vibe-coding
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# cleanvibe
+
+A tiny Python CLI that scaffolds AI-assisted coding projects and launches Claude Code.
+
+`cleanvibe` is not a coding tool. It's a **state initializer** -- it removes the friction between "I want to build something" and "Claude is working inside a well-structured environment." The real value lives in the `CLAUDE.md` it injects: an opinionated behavior contract that enforces documentation discipline, meaningful commits, and iterative file-based thinking.
+
+## Install
+
+```
+pip install cleanvibe
+```
+
+## Usage
+
+### Create a new project
+
+```
+cleanvibe new my-project
+```
+
+This will:
+1. Create the directory `my-project/`
+2. Write `CLAUDE.md` (workflow rules for AI-assisted development)
+3. Write `README.md` (starter documentation)
+4. Write `.gitignore` (sensible Python defaults)
+5. Initialize a git repo with an initial commit
+6. Launch Claude Code inside the project
+
+### Clone an existing repo
+
+```
+cleanvibe clone https://github.com/user/repo
+```
+
+This will:
+1. `git clone` the repository
+2. Check for missing `CLAUDE.md`, `README.md`, `.gitignore`
+3. Inject any missing files without overwriting existing ones
+4. Launch Claude Code inside the project
+
+### Options
+
+```
+cleanvibe new my-project --dry-run     # Preview what would be created
+cleanvibe new my-project --no-claude   # Skip launching Claude Code
+cleanvibe clone REPO path --dry-run    # Preview what would be done
+cleanvibe --version                    # Show version
+```
+
+## Why?
+
+Most people struggle with blank repo paralysis, poor commit hygiene, and AI assistants that ramble without producing durable artifacts. `cleanvibe` solves this by injecting a disciplined thinking contract into every project from the start.
+
+The `CLAUDE.md` template enforces:
+- Commit early and often with meaningful messages
+- No planning-only modes -- all thinking produces files and commits
+- Keep documentation up to date as the project evolves
+- Use `planning/` directories for exploration instead of internal planning modes
+
+## Cross-platform
+
+Works on Windows, Linux, and macOS. Zero dependencies beyond Python 3.9+.
+
+## License
+
+MIT

cleanvibe-0.1.2/cleanvibe.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+cleanvibe/__init__.py
+cleanvibe/cli.py
+cleanvibe/scaffold.py
+cleanvibe/templates.py
+cleanvibe.egg-info/PKG-INFO
+cleanvibe.egg-info/SOURCES.txt
+cleanvibe.egg-info/dependency_links.txt
+cleanvibe.egg-info/entry_points.txt
+cleanvibe.egg-info/top_level.txt

cleanvibe-0.1.2/cleanvibe.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cleanvibe-0.1.2/cleanvibe.egg-info/entry_points.txt

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

cleanvibe-0.1.2/cleanvibe.egg-info/top_level.txt

@@ -0,0 +1 @@
+cleanvibe

cleanvibe-0.1.2/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cleanvibe"
+version = "0.1.2"
+description = "A workflow accelerator that scaffolds AI-assisted coding projects with opinionated documentation and launches Claude Code."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+    { name = "Immanuelle" },
+]
+keywords = ["claude", "ai", "scaffold", "workflow", "vibe-coding"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development",
+    "Topic :: Utilities",
+]
+
+[project.scripts]
+cleanvibe = "cleanvibe.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/Immanuelle/cleanvibe"
+Issues = "https://github.com/Immanuelle/cleanvibe/issues"

cleanvibe-0.1.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+