Metadata-Version: 2.4
Name: usetraces
Version: 0.1.3
Summary: KiCad plugin for schematic metadata reconciliation, supplier sourcing, datasheets, and AI-powered design checks.
License-Expression: GPL-3.0-or-later
Project-URL: Homepage, https://usetraces.com
Project-URL: Repository, https://github.com/usetraces/traces
Project-URL: Changelog, https://github.com/usetraces/traces/releases
Keywords: kicad,pcb,electronics,schematic,datasheet
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Plugins
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Manufacturing
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# traces

KiCad plugin for schematic metadata reconciliation, supplier sourcing, datasheets, and AI-powered design checks.

The `usetraces` KiCad plugin is licensed under GPL-3.0-or-later. The hosted traces service is separate proprietary infrastructure.

## Install

With uv:

```bash
uv tool install usetraces
usetraces install
```

Or with pip:

```bash
pip install usetraces
usetraces install
```

Restart KiCad, then launch from: **PCB Editor → Tools → External Plugins → traces**

## Uninstall

```bash
usetraces uninstall
```

If installed with uv:

```bash
uv tool uninstall usetraces
```

If installed with pip:

```bash
pip uninstall usetraces
```

## First launch

The plugin will open a sign-in page in your browser. Create an account or sign in, then return to KiCad — the plugin polls automatically and opens once authenticated.

## Account menu

The bottom bar of the plugin shows your email as a menu button. Click it to:

- **View usage** — shows current month AI spend vs. your tier limit, plus raw token counts
- **Log out** — clears the saved token; the next launch will prompt for sign-in

## Workflow steps

| Step | What it does |
|------|-------------|
| Footprints | Edit Value + Footprint for each part; or reconcile missing footprints from the PCB layout |
| Supplier | Set LCSC, Digi-Key, or N/A per part |
| Source | AI-powered supplier lookup — finds part number, stock, price |
| Datasheets | Fetches and downloads datasheet PDFs |
| SRC | AI schematic review checks: typos, consistency, orphans, near-duplicates |

In the Source step, **Clear sourcing** removes the current part number/qty/price so you can re-source. Switching supplier also clears sourcing data automatically.
