Metadata-Version: 2.4
Name: unvibecode
Version: 0.4.0
Summary: Analyze repositories using the hosted UnvibeCode engine
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# UnvibeCode

Turn a source repository into business workflows, a connected code map, risk
findings and downloadable repository context using the hosted UnvibeCode engine.

## Install

Python 3.11 or newer is required.

```bash
python -m pip install --upgrade unvibecode
```

## Analyze

```bash
unvibecode review --repository "/path/to/repository"
```

On Windows:

```powershell
unvibecode review --repository "E:\repoanalysis\PocketFlow-main"
```

No account, API key, configuration command or SSH tunnel is required during the
public preview. An internet connection is required. The command uploads selected
source files, waits for hosted analysis, downloads the complete results folder
and opens the final HTML in your default browser. Use `python -m unvibecode` if
the executable is not on PATH.

## Source uploads and retention

Version 0.4.0 moves analysis to the hosted service. Selected source files leave
your computer; do not submit a repository you are not permitted to upload.

Preview the upload file list without sending it:

```bash
unvibecode review --repository "/path/to/repository" --dry-run
```

The client excludes common credential filenames, dependencies, binaries,
symlinks and generated output folders. It uses a text-extension allowlist and
filename exclusions, not full .gitignore semantics or a comprehensive secret
scanner. Hardcoded secrets may remain. Original local files are not modified.

The service deletes the input upload after completion/failure. Reports,
intermediate files and logs may contain source and are retained for approximately
24 hours after completion while the service is running. Local downloaded results
remain until you delete them.

Public-preview job IDs are unguessable bearer references: anyone you share a job
ID with can check or download that job during retention. There is no account-based
ownership. Keep job IDs private. There is no public job-list endpoint.

## Options

```bash
unvibecode health
unvibecode review --repository "/path/to/repository" --output "./reports"
unvibecode review --repository "/path/to/repository" --no-open-browser
unvibecode resume JOB_ID --output "./reports"
```

On an interruption or recoverable connection error, use the displayed resume
command rather than starting another analysis. It does not automatically repeat a paid analysis request.

Public preview currently processes one repository at a time. If busy, retry later.
Existing limits: 50 MiB compressed input, 200 MiB extracted input, 10,000 archive
entries, 10 MiB per source file and a one-hour analysis timeout. The package
contains only the HTTP client and file handling; no proprietary engine code,
taxonomy, database or model-provider key is distributed.
