> ## Documentation Index
> Fetch the complete documentation index at: https://docs.akua.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# akua pkg add

> Add a dependency to akua.toml and lock it

```sh theme={null}
akua pkg add [flags] <name>
```

| Argument | Required | Description |
| - | - | - |
| `<name>` | yes | Local alias: the key in `[dependencies]` |

| Flag | Type | Description |
| - | - | - |
| `--oci` | string | OCI reference (`oci://registry/repo`) |
| `--git` | string | Git repository URL |
| `--path` | string | Local path, relative to the workspace |
| `--repo` | string | HTTPS Helm repository URL (with `--chart`) |
| `--chart` | string | Chart name within the Helm repo (required with `--repo`) |
| `--version` | string | Version (OCI) or semver requirement (Helm) |
| `--tag` | string | Git tag |
| `--rev` | string | Git commit (full SHA) |
| `--force` | boolean | Replace an existing entry under `name` |
| `--workspace` | string | Workspace root containing akua.toml |

Every command also accepts the [universal flags](/akua/cli#universal-flags).

## Related topics

<CardGroup cols={2}>
  <Card title="akua pkg commands" icon="terminal" href="/akua/cli">
    Every command, the universal flags and the exit codes.
  </Card>

  <Card title="Error codes" icon="triangle-exclamation" href="/akua/errors">
    What each structured error means and how to resolve it.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.