AgentStation Nix Packages

This repository provides Nix packages for AgentStation CLI tools, enabling installation via Nix, Devbox, or any Nix-compatible system.

Available Packages

• pocket - Graph execution engine for LLM workflows
• tydirium - Email authentication checker

Installation

Using Devbox

Devbox users can add these tools to their project:

# Add to your project
devbox add github:agentstation/nix-packages#pocket
devbox add github:agentstation/nix-packages#tydirium

# Or add to devbox.json
{
  "packages": [
    "github:agentstation/nix-packages#pocket",
    "github:agentstation/nix-packages#tydirium"
  ]
}

Using Nix

Run directly without installing:

nix run github:agentstation/nix-packages#pocket -- --help
nix run github:agentstation/nix-packages#tydirium -- --help

Install to user profile:

nix profile install github:agentstation/nix-packages#pocket
nix profile install github:agentstation/nix-packages#tydirium

Use in a Nix flake:

{
  inputs = {
    agentstation.url = "github:agentstation/nix-packages";
  };

  outputs = { self, nixpkgs, agentstation }: {
    # Use agentstation.packages.${system}.pocket
    # Use agentstation.packages.${system}.tydirium
  };
}

Using nix-shell

Create a temporary shell with the tools:

nix shell github:agentstation/nix-packages#pocket
nix shell github:agentstation/nix-packages#tydirium

Package Details

pocket

Graph execution engine for LLM workflows - CLI tool for executing workflows defined as graphs.

pocket run workflow.yaml      # Run a workflow
pocket validate workflow.yaml # Validate workflow syntax
pocket nodes list            # List available nodes
pocket --help               # Show all commands

tydirium

Email authentication checker - "It's an older email, sir, but it checks out."

tydirium example.com          # Check a domain
tydirium user@example.com     # Check an email address
tydirium -q example.com       # Quick mode (3 DNS servers)
tydirium -v example.com       # Verbose mode (detailed output)
tydirium -V                   # Show version

Alternative Installation Methods

These tools are also available via Homebrew:

brew tap agentstation/tap
brew install pocket tydirium

Development

To work on these packages:

# Clone the repository
git clone https://github.com/agentstation/nix-packages.git
cd nix-packages

# Enter development shell
nix develop

# Test a package build
nix build .#pocket
nix build .#tydirium

License

All packages in this repository follow their upstream licenses (MIT).