> For the complete documentation index, see [llms.txt](https://docs.talus.network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.talus.network/talus-docs-v2.1.0/reference/cli/tap.md).

# nexus tap

**Audience:** Nexus CLI users and integrators.

**Command:** `nexus tap`.

**Generated from:** Nexus CLI `v2.1.0` release executable at commit `45d397aafcfbeeeaf5032d5fb9fa5d99b3f36205` (help capture is source-verified; generated inventory is preserved below).

Here, Talus Agent Package (TAP) names the package and Agent compatibility surface; the backticked `tap` names the CLI namespace.

This page is the complete help tree for `nexus tap`. Global output flags can appear after the family or nested subcommand.

The TAP family remains the compatibility surface for package and Agent operations. Tool authorization is exposed by `nexus execution authorize`, and timeout/refund identifies the exact `invocation_id`; do not use a cashier-wide payment candidate from historical TAP help as a substitute. `--invocation-id` is optional only when the selected command proves one unique candidate—pass the exact ID whenever a lock is known. The effective walk timeout includes the five-second leader-evaluation buffer, so its permissionless recovery boundary is twice the effective value rather than twice the displayed base timeout. See [Invocation policy and settlement model](/talus-docs-v2.1.0/concepts/06-payment-vaults-reserves-and-settlement.md#invocation-policy-and-settlement-model).

```
Prepare and operate standard TAP skills

Usage: nexus tap [OPTIONS] <COMMAND>

Commands:
  scaffold               Scaffold a TAP package and DAG-backed skill config.
  validate-skill         Validate a TAP skill config and local TAP package metadata.
  publish-skill          Publish a TAP package, DAG, and publish artifact.
  create-skill-artifact  Create a TAP skill publish artifact from explicit inputs and fetched DAG
                         data.
  create-agent           Create a standard Talus agent.
  register-skill         Register a TAP skill from a publish artifact.
  update-skill           Update an existing TAP skill from a publish artifact.
  agent                  Manage locally saved Talus agent aliases.
  vault                  Inspect Talus agent payment vaults.
  payments               Inspect standard TAP execution payments and history.
  execution              Settle or abort active TAP executions.
  registry               Inspect the agent registry.
  default-agent          Inspect the standard TAP default agent metadata.
  bind                   Create a Talus agent and register its first skill atomically.
  requirements           Fetch live skill requirements from the agent registry.
  dry-run                Validate TAP skill config, DAG, and package metadata (the generated CLI help overstates this as input dry-run).
  help                   Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap test`

Run a TAP Move unit-test suite in a local Sui VM with Nexus bytecode published in the selected environment. The command resolves MVR packages, reads Nexus modules from Sui, adds test-only module extensions in memory, and verifies the result before execution. It does not require a wallet, private key, gas, or Nexus source and does not publish, register, bind, schedule, settle, or move assets.

```
Usage: nexus tap test [OPTIONS] [FILTER]

Arguments:
  [FILTER]  Run only tests whose fully qualified name contains this value.

Options:
  -p, --path <PATH>          Path to the TAP Move package. [default: .]
  -e, --build-env <ENV>      Published Nexus environment: `testnet` or `mainnet`. [default: testnet]
  -l, --list                 List matching tests without running them.
  -t, --threads <COUNT>      Number of unit-test threads. [default: 8]
```

Use `--list` or a fully qualified test-name filter to isolate the first concrete failure, then rerun the same package without a filter as the final VM gate. Keep this local published-bytecode evidence separate from pure Move tests, structural DAG/TAP validation, and live network execution.

#### `nexus tap scaffold`

```
Scaffold a TAP package and DAG-backed skill config.

Usage: nexus tap scaffold [OPTIONS] --name <NAME>

Options:
  -n, --name <NAME>      Skill/package name.
      --target <TARGET>  Directory where the TAP package folder will be created. [default: .]
  -h, --help             Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap validate-skill`

```
Validate a TAP skill config and local TAP package metadata.

Usage: nexus tap validate-skill [OPTIONS] --config <CONFIG>

Options:
  -c, --config <CONFIG>  Path to the TAP skill config JSON.
  -h, --help             Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap publish-skill`

```
Publish a TAP package, DAG, and publish artifact.

Usage: nexus tap publish-skill [OPTIONS] --config <CONFIG>

Options:
  -c, --config <CONFIG>                  Path to the TAP skill config JSON.
      --workflow-package <PACKAGE_ID>    Workflow package used to create the DAG.
      --out <OUT>                        Write the publish artifact JSON to this path.
  -h, --help                             Print help

Gas:
  -g, --sui-gas-coin <OBJECT_ID>  Optional owned gas coin object ID. Most commands use address
                                  balance gas when omitted.
  -b, --sui-gas-budget <MIST>     Maximum MIST spent on Sui transaction gas. [default: 100000000]

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap create-skill-artifact`

```
Create a TAP skill publish artifact from explicit inputs and fetched DAG data.

Usage: nexus tap create-skill-artifact [OPTIONS] --skill-name <NAME> --dag-id <OBJECT_ID> --interface-revision <U64> --payment-mode <MODE> --out <OUT>

Options:
      --skill-name <NAME>
          Skill name recorded in the artifact.
      --dag-id <OBJECT_ID>
          Published DAG object ID.
      --interface-revision <U64>
          Skill interface revision.
      --payment-mode <MODE>
          Skill payment policy mode. [possible values: user-funded, agent-funded]
      --agent-funded-max-budget-mist <MIST>
          Maximum budget in MIST for agent-funded skills.
      --recurrence-kind <RECURRENCE_KIND>
          Schedule recurrence kind. [default: once]
      --min-interval-ms <MIN_INTERVAL_MS>
          Minimum interval in milliseconds. [default: 0]
      --max-occurrences <MAX_OCCURRENCES>
          Maximum occurrences. [default: 1]
      --fixed-tool <REGISTRY=FQN>
          Fixed tool requirement as <TOOL_REGISTRY_ID>=<TOOL_FQN>. Repeatable.
      --out <OUT>
          Write the publish artifact JSON to this path.
  -h, --help
          Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap create-agent`

```
Create a standard Talus agent.

Usage: nexus tap create-agent [OPTIONS]

Options:
  -h, --help  Print help

Gas:
  -g, --sui-gas-coin <OBJECT_ID>  Optional owned gas coin object ID. Most commands use address
                                  balance gas when omitted.
  -b, --sui-gas-budget <MIST>     Maximum MIST spent on Sui transaction gas. [default: 100000000]

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap register-skill`

```
Register a TAP skill from a publish artifact.

Usage: nexus tap register-skill [OPTIONS] --artifact <ARTIFACT> --agent-id <OBJECT_ID>

Options:
      --artifact <ARTIFACT>   Path to the publish artifact JSON.
      --agent-id <OBJECT_ID>  On-chain generated agent ID.
  -h, --help                  Print help

Gas:
  -g, --sui-gas-coin <OBJECT_ID>  Optional owned gas coin object ID. Most commands use address
                                  balance gas when omitted.
  -b, --sui-gas-budget <MIST>     Maximum MIST spent on Sui transaction gas. [default: 100000000]

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap update-skill`

```
Update an existing TAP skill from a publish artifact.

Usage: nexus tap update-skill [OPTIONS] --artifact <ARTIFACT> --agent-id <OBJECT_ID> --skill-id <U64>

Options:
      --artifact <ARTIFACT>   Path to the publish artifact JSON.
      --agent-id <OBJECT_ID>  On-chain generated agent ID.
      --skill-id <U64>        Agent-local generated skill index.
  -h, --help                  Print help

Gas:
  -g, --sui-gas-coin <OBJECT_ID>  Optional owned gas coin object ID. Most commands use address
                                  balance gas when omitted.
  -b, --sui-gas-budget <MIST>     Maximum MIST spent on Sui transaction gas. [default: 100000000]

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap agent`

```
Manage locally saved Talus agent aliases.

Usage: nexus tap agent [OPTIONS] <COMMAND>

Commands:
  save    Save a Talus agent under a local alias.
  list    List locally saved Talus agent aliases.
  remove  Remove a locally saved Talus agent alias.
  help    Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap agent save`

```
Save a Talus agent under a local alias.

Usage: nexus tap agent save [OPTIONS] --name <NAME> --agent-id <OBJECT_ID>

Options:
      --name <NAME>           Local alias.
      --agent-id <OBJECT_ID>  Talus agent object ID.
  -h, --help                  Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap agent list`

```
List locally saved Talus agent aliases.

Usage: nexus tap agent list [OPTIONS]

Options:
  -h, --help  Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap agent remove`

```
Remove a locally saved Talus agent alias.

Usage: nexus tap agent remove [OPTIONS] --name <NAME>

Options:
      --name <NAME>  Local alias.
  -h, --help         Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap vault`

```
Inspect Talus agent payment vaults.

Usage: nexus tap vault [OPTIONS] <COMMAND>

Commands:
  balance  Show a Talus agent payment-vault balance.
  deposit  Deposit MIST into a Talus agent payment vault.
  help     Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap vault balance`

```
Show a Talus agent payment-vault balance.

Usage: nexus tap vault balance [OPTIONS]

Options:
      --alias <NAME>          Local agent alias.
      --agent-id <OBJECT_ID>  Talus agent object ID.
  -h, --help                  Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap vault deposit`

```
Deposit MIST into a Talus agent payment vault.

Usage: nexus tap vault deposit [OPTIONS] --amount <AMOUNT>

Options:
      --alias <NAME>          Local agent alias.
      --agent-id <OBJECT_ID>  Talus agent object ID.
      --amount <AMOUNT>       Amount in MIST to deposit.
  -h, --help                  Print help

Gas:
  -g, --sui-gas-coin <OBJECT_ID>  Optional owned gas coin object ID. Most commands use address
                                  balance gas when omitted.
  -b, --sui-gas-budget <MIST>     Maximum MIST spent on Sui transaction gas. [default: 100000000]

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap payments`

```
Inspect standard TAP execution payments and history.

Usage: nexus tap payments [OPTIONS] <COMMAND>

Commands:
  show    Show a standard TAP execution payment by ID.
  wait    Wait for a standard TAP execution payment to settle.
  refill  Refill a live TAP execution payment. Uses a coin top-up by default, or the agent vault
          when `--alias`/`--agent-id` is supplied.
  help    Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap payments show`

```
Show a standard TAP execution payment by ID.

Usage: nexus tap payments show [OPTIONS] --payment-id <OBJECT_ID>

Options:
      --payment-id <OBJECT_ID>  Execution payment object ID.
  -h, --help                    Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap payments wait`

```
Wait for a standard TAP execution payment to settle.

Usage: nexus tap payments wait [OPTIONS] --payment-id <OBJECT_ID>

Options:
      --payment-id <OBJECT_ID>       Execution payment object ID.
      --timeout-secs <TIMEOUT_SECS>  Maximum seconds to wait. [default: 120]
      --poll-secs <POLL_SECS>        Seconds between polls. [default: 2]
  -h, --help                         Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap payments refill`

```
Refill a live TAP execution payment. Uses a coin top-up by default, or the agent vault when
`--alias`/`--agent-id` is supplied.

Usage: nexus tap payments refill [OPTIONS] --execution-id <OBJECT_ID> --amount <AMOUNT>

Options:
      --execution-id <OBJECT_ID>  Shared `DAGExecution` object ID whose TAP payment should be
                                  refilled.
      --amount <AMOUNT>           MIST amount to add to the execution payment.
      --alias <NAME>              Local agent alias whose vault funds the refill.
      --agent-id <OBJECT_ID>      Talus agent object ID whose vault funds the refill.
  -h, --help                      Print help

Gas:
  -g, --sui-gas-coin <OBJECT_ID>  Optional owned gas coin object ID. Most commands use address
                                  balance gas when omitted.
  -b, --sui-gas-budget <MIST>     Maximum MIST spent on Sui transaction gas. [default: 100000000]

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

The refill transaction also requests every active walk whose payment is ready. It does not settle a committed result already retained in `PendingSettlement`; after the refill, run the eligible `nexus tap execution settle` transition for that walk and verify the committed result and insufficient-payment marker clear.

#### `nexus tap execution`

```
Settle or abort active TAP executions.

Usage: nexus tap execution [OPTIONS] <COMMAND>

Commands:
  resolve-expired-walk  Resolve one double-timeout TAP DAG execution walk.
  settle                Permissionlessly settle one committed result walk after it is eligible.
  abort                 Permissionlessly abort an expired TAP DAG execution.
  help                  Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap execution resolve-expired-walk`

```
Resolve one double-timeout TAP DAG execution walk.

Usage: nexus tap execution resolve-expired-walk [OPTIONS] --execution-id <OBJECT_ID> --walk-index <WALK_INDEX>

Options:
      --execution-id <OBJECT_ID>     Shared `DAGExecution` object ID to resolve.
      --walk-index <WALK_INDEX>      Expired walk index to resolve.
      --invocation-id <OBJECT_ID>    Invocation object ID to refund when more than one candidate exists.
  -h, --help                         Print help

Gas:
  -g, --sui-gas-coin <OBJECT_ID>  Optional owned gas coin object ID. Most commands use address
                                  balance gas when omitted.
  -b, --sui-gas-budget <MIST>     Maximum MIST spent on Sui transaction gas. [default: 100000000]

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap execution settle`

```
Permissionlessly settle one committed result walk after it is eligible.

Usage: nexus tap execution settle [OPTIONS] --execution-id <OBJECT_ID> --walk-index <WALK_INDEX>

Options:
      --execution-id <OBJECT_ID>  Shared `DAGExecution` object ID to settle.
      --walk-index <WALK_INDEX>   Committed-result walk index to settle.
  -h, --help                      Print help

Gas:
  -g, --sui-gas-coin <OBJECT_ID>  Optional owned gas coin object ID. Most commands use address
                                  balance gas when omitted.
  -b, --sui-gas-budget <MIST>     Maximum MIST spent on Sui transaction gas. [default: 100000000]

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

This command settles the eligible committed result and then requests every active walk whose payment is ready in the same transaction. After success, verify both the cleared result/lock state and the request events for eligible active walks.

#### `nexus tap execution abort`

```
Permissionlessly abort an expired TAP DAG execution.

Usage: nexus tap execution abort [OPTIONS] --execution-id <OBJECT_ID>

Options:
      --execution-id <OBJECT_ID>  Shared `DAGExecution` object ID to abort.
  -h, --help                      Print help

Gas:
  -g, --sui-gas-coin <OBJECT_ID>  Optional owned gas coin object ID. Most commands use address
                                  balance gas when omitted.
  -b, --sui-gas-budget <MIST>     Maximum MIST spent on Sui transaction gas. [default: 100000000]

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap registry`

```
Inspect the agent registry.

Usage: nexus tap registry [OPTIONS] <COMMAND>

Commands:
  show  Print the agent registry contents as JSON.
  help  Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap registry show`

```
Print the agent registry contents as JSON.

Usage: nexus tap registry show [OPTIONS]

Options:
  -h, --help  Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap default-agent`

```
Inspect the standard TAP default agent metadata.

Usage: nexus tap default-agent [OPTIONS] <COMMAND>

Commands:
  show  Print the configured standard TAP default agent as JSON.
  help  Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap default-agent show`

```
Print the configured standard TAP default agent as JSON.

Usage: nexus tap default-agent show [OPTIONS]

Options:
  -h, --help  Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap bind`

```
Create a Talus agent and register its first skill atomically.

Usage: nexus tap bind [OPTIONS] --artifact <ARTIFACT>

Options:
      --artifact <ARTIFACT>  Path to the publish artifact JSON.
  -h, --help                 Print help

Gas:
  -g, --sui-gas-coin <OBJECT_ID>  Optional owned gas coin object ID. Most commands use address
                                  balance gas when omitted.
  -b, --sui-gas-budget <MIST>     Maximum MIST spent on Sui transaction gas. [default: 100000000]

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap requirements`

```
Fetch live skill requirements from the agent registry.

Usage: nexus tap requirements [OPTIONS] --agent-id <OBJECT_ID> --skill-id <U64>

Options:
      --agent-id <OBJECT_ID>  On-chain generated agent ID.
      --skill-id <U64>        Agent-local generated skill index.
  -h, --help                  Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```

#### `nexus tap dry-run` metadata validation

{% hint style="danger" %}
Handler scope: `dry-run --config` validates SkillConfig, DAG, and package metadata only. It has no sample-input flag or input-execution path, despite the misleading clap description below. It does not execute user inputs.
{% endhint %}

```
Validate TAP skill config, DAG, and package metadata. The generated CLI help prints a broader “user inputs” description, but the handler has no input flag or execution path.

Usage: nexus tap dry-run [OPTIONS] --config <CONFIG>

Options:
  -c, --config <CONFIG>  Path to the TAP skill config JSON.
  -h, --help             Print help

Output:
      --json        Emit machine readable JSON
  -v, --verbose...  Increase diagnostic detail
  -q, --quiet...    Show errors only
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.talus.network/talus-docs-v2.1.0/reference/cli/tap.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.