# cargo-faircode

[Faircode](https://faircode.io) helps companies keep track of and pay for the software they use. The `cargo-faircode` cargo extension searches your project for dependencies and lists the ones with Faircode IDs associated with them.

To install:
```sh
cargo install cargo-faircode
```

Then to list all locally installed packages with Faircode IDs:
```sh
cargo faircode list
```

We recommend running `cargo faircode register-build` after each build of your package (for instance on CI). This automatically updates your software subscriptions on Faircode (removing old ones, adding new ones), to make sure you're always in sync.

You can list available commands with
```sh
cargo help faircode
```

To add a Faircode ID to your own project, first register at [faircode.io](https://faircode.io), then update your `Cargo.toml`:
```toml
[package.metadata.faircode]
faircode_id = "YOUR_ID"
```