---
title: "una ita"
url: https://una-lang.org/en/docs/cli/ita/
release: v0.4.0
---

# una ita

The package manager of edition 0.4: dependencies, `ita.una` and `ita.lock`.

```text
una ita [OPTIONS] <COMMAND>
```

## Commands

| Command | What it does |
| --- | --- |
| `una ita remove` | Remove a need from ita.una, then write the lock |
| `una ita tree` | Print the program's packages, with their ceilings, authority and trust |
| `una ita lock` | Write `ita.lock` for the package, or check it with --check |
| `una ita update` | Raise the named needs, or all, and write the lock, for the package in the current directory |
| `una ita add` | Add a need to ita.una and write the lock, for the package in the current directory |
| `una ita fetch` | Fetch each locked registry package into Itaoca, verified, with its provenance |
| `una ita vendor` | Copy each locked registry package from Itaoca into vendor/ita/, with its provenance |
| `una ita verify` | Verify each locked registry package again, in vendor/ita/ and in Itaoca |
| `una ita publish` | Check, build, sign and send a release of the package to the registry it names |
| `una ita yank` | Yank a release of the package: new resolutions skip it, and existing locks keep it |
| `una ita audit` | Check each locked registry package for yanks, advisories and key changes (U7014) |
| `una ita watch` | Print the new entries of an owner's chains, and any promise its registry broke |
| `una ita bundle` | Write each locked registry package, with its provenance, into one file |
| `una ita unbundle` | Verify a bundle against the lock, and store its packages in Itaoca |

## Options

| Option | What it does | Default |
| --- | --- | --- |
| `--json` | Print machine output as JSON on stdout, and nothing else on stdout |  |
| `--color <WHEN>` | When to use colors in human output. Values: `never`: Never use colors; `auto`: Use colors when the output is a terminal; `always`: Always use colors. | `auto` |

## Specification

The normative rules, from spec/13 §5:

| Command | Meaning |
| --- | --- |
| `una ita <command>` | (v0.4, ADR 0122) The package manager of edition `0.4`: `lock`, `update`, `add`, `remove`, `tree`, `fetch`, `vendor`, `verify`, `publish`, `yank`, `audit`, `watch`, `bundle` and `unbundle`; the binary run as `ita` is `una ita` (`spec/30 §6`) |




## Help text

As `una ita --help` prints it at v0.4.0:

```text
The package manager of edition 0.4: dependencies, `ita.una` and `ita.lock`

Usage: una ita [OPTIONS] <COMMAND>

Commands:
  remove    Remove a need from ita.una, then write the lock
  tree      Print the program's packages, with their ceilings, authority and trust
  lock      Write `ita.lock` for the package, or check it with --check
  update    Raise the named needs, or all, and write the lock, for the package in the current directory
  add       Add a need to ita.una and write the lock, for the package in the current directory
  fetch     Fetch each locked registry package into Itaoca, verified, with its provenance
  vendor    Copy each locked registry package from Itaoca into vendor/ita/, with its provenance
  verify    Verify each locked registry package again, in vendor/ita/ and in Itaoca
  publish   Check, build, sign and send a release of the package to the registry it names
  yank      Yank a release of the package: new resolutions skip it, and existing locks keep it
  audit     Check each locked registry package for yanks, advisories and key changes (U7014)
  watch     Print the new entries of an owner's chains, and any promise its registry broke
  bundle    Write each locked registry package, with its provenance, into one file
  unbundle  Verify a bundle against the lock, and store its packages in Itaoca

Options:
      --json
          Print machine output as JSON on stdout, and nothing else on stdout

      --color <WHEN>
          When to use colors in human output

          Possible values:
          - never:  Never use colors
          - auto:   Use colors when the output is a terminal
          - always: Always use colors

          [default: auto]

  -h, --help
          Print help (see a summary with '-h')
```
