Nexus SDK

The Nexus SDK is a collection of tools that simplifies building with Nexus, the Agentic Workflow Engine. Developers can quickly create Talus agents or Talus tools.

This repository includes open-source Nexus packages:

• nexus-cli
• nexus-sdk
• nexus-toolkit-rust
• nexus-walrus
• Standard Nexus Tools

---

For complete documentation, visit the official Nexus SDK docs.

Installation

You can install Nexus CLI using several convenient methods:

Using Homebrew (macOS/Linux)

brew tap talus-network/tap
brew install nexus-cli

Arch Linux

The nexus-cli is also available in the AUR (Arch User Repository). You can install it using your preferred AUR helper:

yay -S nexus-cli

Using cargo-binstall (recommended for faster binaries)

If you prefer quicker binary installation, use cargo-binstall:

cargo binstall --git https://github.com/talus-network/nexus-sdk nexus-cli

Using Cargo

To install directly from the source using cargo, run:

cargo install nexus-cli \
  --git https://github.com/talus-network/nexus-sdk \
  --tag v2.2.0 \
  --locked

Usage

Run the nexus command to see all the available options:

$ nexus help
Nexus CLI

Usage: nexus [OPTIONS] <COMMAND>

Commands:
  tool        Manage Nexus Tools
  conf        Manage Nexus Configuration
  dag         Validate and publish Nexus DAGs
  task        Create and operate scheduled Tasks
  gas         Manage Nexus gas budgets and tickets
  tap         Prepare, test and operate TAP applications
  completion  Provide shell completions
  help        Print this message or the help of the given subcommand(s)

Options:
      --json        Emit machine readable JSON
  -v, --verbose...  More output per occurrence
  -q, --quiet...    Less output per occurrence
  -h, --help        Print help
  -V, --version     Print version

Scheduled work follows one model:

Task -> Schedule -> Occurrence

Create an empty Task when composing it across later transactions. Use nexus task schedule when the initial Schedule is already known; the command requires at least one occurrence or recurrence and applies the Schedule atomically. Run nexus task --help for timing, funding, recurrence, and object inspection examples. Use nexus task occurrence list --task-id <OBJECT_ID> --json to page through every retained occurrence record.

TAP authors can run Move unit tests against published Nexus bytecode with nexus tap test --path tap. The command runs exact published Nexus functions and developer test extensions in one local Sui VM. See the canonical TAP development and testing guide for an embedded application that owns its Agent, builds its DAG, schedules a Task, authenticates an onchain Tool callback and finalizes a Nexus result. The guide also defines the boundary between local unit tests and Testnet integration.

nexus tap scaffold creates the standard CLI managed TAP form. The embedded application example is the starting point when Move state should own the Agent and lifecycle.

For more detailed instructions, visit the Nexus CLI documentation.

Development

We use just, a straightforward command runner similar to make.

To explore the available tasks, run:

$ just --list
Available recipes:
    cli ...          # Commands concerning Nexus CLI
    sdk ...          # Commands concerning the Nexus SDK
    toolkit-rust ... # Commands concerning Nexus Toolkit for Rust

Learn more about just in the official manual.