anyt-ads-cli — Unified CLI for AdAnt

anyt-ads-cli is the command-line client for the AdAnt v1 API. It manages skills, notebooks, drive files, agents, API keys, billing, and more — all through a single anyt-ads-cli binary.

Skills support Claude Code, Cursor, Codex, Gemini CLI, Windsurf, and 40+ more agents.

Website: adant.up.railway.app Registry: adant.up.railway.app

Install

npm i @anytio/anyt-ads-cli

Or globally:

npm i -g @anytio/anyt-ads-cli

Then run:

npx @anytio/anyt-ads-cli --help

The full surface includes auth, config, skills, skill-lists, notebook, api-keys, credit, billing, drive, agents, artifacts, public-assets, favorites, media, session, admin, contact, and upgrade. Run npx @anytio/anyt-ads-cli <group> --help for details on each.

Quick Start

# Authenticate (browser-based OAuth)
npx @anytio/anyt-ads-cli auth login

# Check who you're logged in as
npx @anytio/anyt-ads-cli auth whoami

# Initialize a new skill manifest
npx @anytio/anyt-ads-cli skills init

# Add a skill from the registry
npx @anytio/anyt-ads-cli skills add @user/username/skill-name

# List installed skills
npx @anytio/anyt-ads-cli skills list

# Install all skills from the lockfile
npx @anytio/anyt-ads-cli skills install

# Publish a skill to the registry
npx @anytio/anyt-ads-cli skills publish --access public --bump patch

Skills

Add a Skill

npx @anytio/anyt-ads-cli skills add <specifier> [--agent <agents>]

Supported specifier formats:

# Registry (with semver)
npx @anytio/anyt-ads-cli skills add @user/username/skill-name
npx @anytio/anyt-ads-cli skills add @user/username/skill-name@^2.0.0
npx @anytio/anyt-ads-cli skills add @org/myorg/team-skill@~1.2.0

# GitHub shorthand
npx @anytio/anyt-ads-cli skills add owner/repo
npx @anytio/anyt-ads-cli skills add owner/repo/path/to/skill

# Full GitHub URL (copy-paste from browser)
npx @anytio/anyt-ads-cli skills add https://github.com/owner/repo/tree/main/skills/web-design

# GitHub with prefix and ref
npx @anytio/anyt-ads-cli skills add github:owner/[email protected]
npx @anytio/anyt-ads-cli skills add github:owner/repo/path/to/skill@main

# Local path (development)
npx @anytio/anyt-ads-cli skills add ./my-local-skill
npx @anytio/anyt-ads-cli skills add file:../shared-skills

# Well-known URL (RFC 8615 discovery)
npx @anytio/anyt-ads-cli skills add https://acme.com

Common Skill Commands

| Command | Description | |---------|-------------| | npx @anytio/anyt-ads-cli skills add <specifier...> | Add and install skills | | npx @anytio/anyt-ads-cli skills install [specifiers...] | Install from lockfile or add packages (alias: i) | | npx @anytio/anyt-ads-cli skills remove <name> | Remove an installed skill (alias: rm) | | npx @anytio/anyt-ads-cli skills list | List installed skills (alias: ls) | | npx @anytio/anyt-ads-cli skills update | Update to latest compatible versions | | npx @anytio/anyt-ads-cli skills outdated [packages...] | Check for outdated skills | | npx @anytio/anyt-ads-cli skills search [query] | Search the registry (alias: find) | | npx @anytio/anyt-ads-cli skills audit | Verify integrity of installed skills | | npx @anytio/anyt-ads-cli skills link | Recreate agent symlinks | | npx @anytio/anyt-ads-cli skills init | Create an anyt.json manifest | | npx @anytio/anyt-ads-cli skills publish | Publish skill to registry | | npx @anytio/anyt-ads-cli skills unpublish <spec> | Remove a published version (within 72h) | | npx @anytio/anyt-ads-cli skills deprecate <spec> | Mark a version as deprecated | | npx @anytio/anyt-ads-cli skills access <spec> | Change package visibility | | npx @anytio/anyt-ads-cli skills version <bump> | Bump version (major / minor / patch) |

Install Options

| Option | Description | |--------|-------------| | -g, --global | Install to user home directory instead of project | | --agent <agents> | Comma-separated agents for symlinks (e.g., claude-code,cursor) | | -y, --yes | Skip prompts and use defaults | | --frozen-lockfile | CI mode — fail if lockfile is outdated | | --dir <path> | Install to a custom directory | | --list <spec> | Install all skills from a skill list |

| Scope | Flag | Skills Location | Symlink Location | |-------|------|-----------------|------------------| | Project | (default) | .anyt/skills/ | ./<agent>/skills/ | | Global | -g | ~/.anyt/skills/ | ~/<agent>/skills/ |

Authentication

npx @anytio/anyt-ads-cli auth login                         # Browser-based OAuth
npx @anytio/anyt-ads-cli auth login --api-key <key>         # Authenticate with API key
npx @anytio/anyt-ads-cli auth logout                        # Clear stored credentials
npx @anytio/anyt-ads-cli auth whoami                        # Show current user info

Configuration

npx @anytio/anyt-ads-cli config show                        # Show resolved configuration
npx @anytio/anyt-ads-cli config init                        # Create a project-level .anytadsrc
npx @anytio/anyt-ads-cli config set-encryption-key @user/yourname <passphrase>
npx @anytio/anyt-ads-cli config get-encryption-key @user/yourname
npx @anytio/anyt-ads-cli config remove-encryption-key @user/yourname

User Config (~/.anytadsrc)

registry = https://adant.up.railway.app
authToken = sk_...
username = myuser

Project Config (.anytadsrc)

registry = https://custom-registry.example.com

Lockfile (anyt-lock.json)

Tracks exact versions, resolved URLs, and integrity hashes for reproducible installs.

Publishing Skills

npx @anytio/anyt-ads-cli skills publish --access public                       # Public release
npx @anytio/anyt-ads-cli skills publish --access private                      # Private (Pro)
npx @anytio/anyt-ads-cli skills publish --access team --org myorg             # Team-only
npx @anytio/anyt-ads-cli skills publish --access public --bump patch          # Bump and publish

--access is required (public, private, or team). --access team requires --org. Public publishes are irreversible.

Before uploading, the CLI shows a preview of included files and the package size. Max package size is 10MB.

Versioning

npx @anytio/anyt-ads-cli skills version major               # 1.0.0 -> 2.0.0
npx @anytio/anyt-ads-cli skills version minor               # 1.0.0 -> 1.1.0
npx @anytio/anyt-ads-cli skills version patch               # 1.0.0 -> 1.0.1
npx @anytio/anyt-ads-cli skills version patch --dry-run     # Preview without writing

Creating a Skill

A skill is a directory containing at minimum a SKILL.md:

---
name: my-skill
description: A helpful skill that does X
---

# My Skill

Instructions for the agent to follow when this skill is activated.

For publishing, also include an anyt.json (created with npx @anytio/anyt-ads-cli skills init):

{
  "name": "@user/myusername/my-skill",
  "version": "1.0.0",
  "description": "A helpful skill for…",
  "files": ["anyt.json", "SKILL.md"]
}

Ignoring Files (.anytignore)

Control which files are excluded when publishing:

# .anytignore
*.test.ts
__tests__/
.env*
*.log

• If .anytignore exists, use it for ignore patterns.
• Otherwise, fall back to .gitignore if present.
• Always ignores node_modules, .git, and .anyt-publish/.

Directory Structure

project/
├── anyt.json               # Manifest with dependencies
├── anyt-lock.json          # Lockfile (version pinning + integrity)
├── .anytadsrc                 # Project config (optional)
├── .anyt/
│   ├── skills/                  # Installed skills (central store)
│   │   ├── username/            # @user/<username>/<name>
│   │   │   └── skillname/SKILL.md
│   │   ├── _org/                # @org/<orgname>/<name>
│   │   ├── _github-registry/    # @github/<owner>/<repo>/<name>
│   │   ├── _wellknown/          # Well-known URL skills
│   │   └── _local/              # Local skill symlinks
│   └── cache/              # Tarball cache
├── .claude/skills/         # Symlinks for Claude Code (and other agents)
└── .cursor/skills/         # Symlinks for Cursor (if configured)

Brain Sessions (session)

Drive a brain chat session end-to-end — create, send turns, browse the message history, and download artifacts:

# Discover skills
npx @anytio/anyt-ads-cli session catalog

# Start a session
npx @anytio/anyt-ads-cli session create --skill brain-general --title "exploration"

# Send a turn (streams thinking, tool calls, and the assistant's reply)
npx @anytio/anyt-ads-cli session chat --session_id <id> "say hello"

# Inspect history and artifacts
npx @anytio/anyt-ads-cli session list
npx @anytio/anyt-ads-cli session messages --session_id <id>
npx @anytio/anyt-ads-cli session artifacts --session_id <id>
npx @anytio/anyt-ads-cli session artifacts get <artifact-id> --out ./out.md

# Manage attached skills
npx @anytio/anyt-ads-cli session skills --session_id <id>
npx @anytio/anyt-ads-cli session skills add @user/alice/research --session_id <id>
npx @anytio/anyt-ads-cli session skills remove brain-doc --session_id <id>

The CLI talks to brain through the unified server (<registry>/api/app/brain) using your sk_* API key — so the same commands work against your local stack or AdAnt. Set ANYT_BRAIN_URL to hit a brain HTTP port directly (for brain-only debugging — artifacts and credit metering require the proxy).

Other Command Groups

npx @anytio/anyt-ads-cli notebook upload notebook.anyt.md     # Notebook management
npx @anytio/anyt-ads-cli notebook list

npx @anytio/anyt-ads-cli drive folders list                   # AI Drive (file storage)
npx @anytio/anyt-ads-cli drive upload <file>

npx @anytio/anyt-ads-cli api-keys list                        # API key management
npx @anytio/anyt-ads-cli api-keys create "ci-bot"

npx @anytio/anyt-ads-cli billing subscription                 # Stripe billing
npx @anytio/anyt-ads-cli billing portal

npx @anytio/anyt-ads-cli agents list                          # Brain agent templates
npx @anytio/anyt-ads-cli artifacts list                       # Brain artifacts (all sessions)
npx @anytio/anyt-ads-cli favorites list                       # Favorites
npx @anytio/anyt-ads-cli media image generate                 # Image generation

npx @anytio/anyt-ads-cli upgrade                              # Self-update anyt-ads-cli

Run npx @anytio/anyt-ads-cli <group> --help for the full surface.

CI/CD Integration

# Set API key via environment variable
export ANYT_API_KEY=sk_ci_key

# Install with frozen lockfile (fails if lockfile outdated)
npx @anytio/anyt-ads-cli skills install --frozen-lockfile

# Audit installed skills
npx @anytio/anyt-ads-cli skills audit --json

Environment Variables

| Variable | Description | |----------|-------------| | ANYT_REGISTRY_URL | Override the default registry URL | | ANYT_API_KEY | API key for authentication | | ANYT_WEB_URL | Override the web app URL (used by auth login) | | ANYT_BRAIN_URL | Override the brain base URL for session … (bypasses the proxy; direct-to-brain only) | | ANYT_DEBUG | Enable debug logging | | ANYT_ENCRYPTION_KEY_<SCOPE> | Encryption key for a scope (e.g., ANYT_ENCRYPTION_KEY_USER_ALICE) | | ANYT_NO_UPDATE_CHECK | Disable the background update notifier | | GITHUB_TOKEN | GitHub token for private repos and higher rate limits |

Configuration resolves in priority order:

1. Environment variables (highest)
2. Project config (.anytadsrc in project directory)
3. User config (~/.anytadsrc)
4. Defaults (lowest)

Self-Update

npx @anytio/anyt-ads-cli upgrade

Auto-detects your package manager (pnpm, npm, yarn, bun). The CLI also checks for updates every 24 hours and notifies you when a newer version is available. Set ANYT_NO_UPDATE_CHECK=1 to disable.

Supported Agents

| Agent | --agent value | Skills Directory | |-------|----------------|------------------| | AdaL | adal | .adal/skills/ | | Amp | amp | .agents/skills/ | | Antigravity | antigravity | .agent/skills/ | | Augment | augment | .augment/skills/ | | Claude Code | claude-code | .claude/skills/ | | Cline | cline | .agents/skills/ | | CodeBuddy | codebuddy | .codebuddy/skills/ | | Codex | codex | .agents/skills/ | | Command Code | command-code | .commandcode/skills/ | | Continue | continue | .continue/skills/ | | Cortex Code | cortex | .cortex/skills/ | | Crush | crush | .crush/skills/ | | Cursor | cursor | .agents/skills/ | | Droid | droid | .factory/skills/ | | Gemini CLI | gemini-cli | .agents/skills/ | | GitHub Copilot | github-copilot | .agents/skills/ | | Goose | goose | .goose/skills/ | | iFlow CLI | iflow-cli | .iflow/skills/ | | Junie | junie | .junie/skills/ | | Kilo Code | kilo | .kilocode/skills/ | | Kimi Code CLI | kimi-cli | .agents/skills/ | | Kiro CLI | kiro-cli | .kiro/skills/ | | Kode | kode | .kode/skills/ | | MCPJam | mcpjam | .mcpjam/skills/ | | Mistral Vibe | mistral-vibe | .vibe/skills/ | | Mux | mux | .mux/skills/ | | Neovate | neovate | .neovate/skills/ | | OpenClaw | openclaw | skills/ | | OpenCode | opencode | .agents/skills/ | | OpenHands | openhands | .openhands/skills/ | | Pi | pi | .pi/skills/ | | Pochi | pochi | .pochi/skills/ | | Qoder | qoder | .qoder/skills/ | | Qwen Code | qwen-code | .qwen/skills/ | | Replit | replit | .agents/skills/ | | Roo Code | roo | .roo/skills/ | | Trae | trae | .trae/skills/ | | Trae CN | trae-cn | .trae/skills/ | | Universal | universal | .agents/skills/ | | Windsurf | windsurf | .windsurf/skills/ | | Zencoder | zencoder | .zencoder/skills/ |

License

This project is licensed under The Artistic License 2.0, the same license used by npm.