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
• 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.0.0-rc.4 \
  --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 and operate standard TAP skills
  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.

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.