Metadata-Version: 2.4
Name: weld-cli
Version: 0.6.0
Summary: Human-in-the-loop coding harness: plan, review, iterate, commit with transcript provenance
Project-URL: Homepage, https://github.com/ametel01/weld-cli
Project-URL: Documentation, https://ametel01.github.io/weld-cli/
Project-URL: Repository, https://github.com/ametel01/weld-cli.git
Project-URL: Issues, https://github.com/ametel01/weld-cli/issues
Project-URL: Changelog, https://github.com/ametel01/weld-cli/blob/master/CHANGELOG.md
Author: Alex Metelli
License-Expression: Apache-2.0
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Version Control :: Git
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: pydantic>=2.6
Requires-Dist: rich>=13.7
Requires-Dist: simple-term-menu>=1.6
Requires-Dist: tomli-w>=1.0
Requires-Dist: typer>=0.12
Description-Content-Type: text/markdown

<p align="center">
  <img src=".github/weld-logo.png" alt="Weld Logo" width="400">
</p>

**Human-in-the-loop coding harness with transcript provenance**

Weld generates structured prompts for AI-assisted development workflows. Instead of ad-hoc prompting, weld provides templates for: research → plan → implement → review → commit.

## Why Weld?

- **Structured Prompts**: Generate focused prompts for research, planning, and review
- **Full Auditability**: Every AI interaction linked via transcript gists in commits
- **Codebase Discovery**: Analyze existing codebases before making changes
- **Spec Refinement**: Interview-style Q&A to improve specifications

```
Spec Doc  -->  Research Prompt  -->  Plan Prompt  -->  Review  -->  Commit
                                                                  + transcript
```

## Install

```bash
uv tool install weld-cli          # or: pipx install weld-cli
uv tool upgrade weld-cli          # upgrade to latest
```

## Quick Start

```bash
weld init                              # Initialize in your project
weld doctor                            # Check environment
weld plan specs/feature.md -o plan.md  # Generate implementation plan
weld implement plan.md                 # Execute plan interactively
weld commit --all                      # Commit with transcript
```

## Documentation

| | |
|---|---|
| **[Installation](docs/installation.md)** | Prerequisites and setup |
| **[Quickstart](docs/quickstart.md)** | Get running in 5 minutes |
| **[Workflow](docs/workflow.md)** | Full development workflow |
| **[Commands](docs/commands/index.md)** | Command reference |
| **[Configuration](docs/configuration.md)** | Config options |
| **[Troubleshooting](docs/troubleshooting.md)** | Common issues |
| **[Development](docs/development/index.md)** | Contributing guide |

## License

See [LICENSE](LICENSE) for details.
