{"_id":"@anytio/anyt-ads-cli","name":"@anytio/anyt-ads-cli","dist-tags":{"latest":"0.4.0"},"versions":{"0.4.0":{"name":"@anytio/anyt-ads-cli","version":"0.4.0","description":"AdAnt CLI — unified client for the AdAnt v1 API (skills, drive, api-keys, billing, agents, …)","author":{"name":"AdAnt"},"license":"Artistic-2.0","keywords":["anyt-ads","adant","cli","skill","package-manager","ai","claude","claude-code","coding-agent"],"type":"module","exports":{".":"./dist/index.js"},"bin":{"anyt-ads-cli":"bin/anyt-ads-cli.js"},"publishConfig":{"access":"public"},"scripts":{"dev":"tsx --tsconfig tsconfig.json src/index.ts","build":"tsdown","start":"node dist/index.js","link:local":"pnpm build && ln -sf $(pwd)/bin/anyt-ads-cli.js $(pnpm bin --global)/anyt-ads-cli-local && echo 'Linked anyt-ads-cli-local → local build'","unlink:local":"rm -f $(pnpm bin --global)/anyt-ads-cli-local && echo 'Removed anyt-ads-cli-local'","typecheck":"tsc --noEmit","lint":"biome lint src","check":"biome check src","format":"biome format ./src --write","test":"vitest run","test:watch":"vitest","test:e2e":"vitest run --config vitest.e2e.config.ts","test:e2e:watch":"vitest --config vitest.e2e.config.ts","prepublishOnly":"pnpm build"},"dependencies":{"@inquirer/prompts":"^8.4.2","commander":"^14.0.3","ignore":"^7.0.5","ini":"^6.0.0","open":"^11.0.0","semver":"^7.7.4"},"devDependencies":{"@anytio/agent-session":"workspace:*","@anytio/artifacts":"workspace:*","@anytio/errors":"workspace:*","@anytio/skill-registry":"workspace:*","@anytio/skill-types":"workspace:*","@anytio/typescript-config":"workspace:*","@biomejs/biome":"2.4.14","@types/ini":"^4.1.1","@types/node":"^25.6.2","@types/semver":"^7.7.1","tsdown":"^0.22.0","tsx":"^4.21.0","typescript":"^6.0.3","vitest":"^4.1.5"},"engines":{"node":">=20.0.0"},"gitHead":"1e6a93dd501a2d61b1d57406270efc774c3afd3a","_id":"@anytio/anyt-ads-cli@0.4.0","_nodeVersion":"24.13.1","_npmVersion":"11.8.0","dist":{"integrity":"sha512-e9zgtV3E9pjrPLfpRpbG3OZgDJ8rro30yfFzj/iBiFm9EI250HfKXkPB7dC4WdK1bnZYXqXSs5tW5iuleCTvmA==","shasum":"4ca10ab7eecd466594b2114493366b3ec5302a90","tarball":"https://registry.npmjs.org/@anytio/anyt-ads-cli/-/anyt-ads-cli-0.4.0.tgz","fileCount":16,"unpackedSize":281799,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD9EjIVKzj/r5ozrUApQ8B19xuErnPSJsdoeG1/1mnB4wIhAKkpsGfXE9NadOIMutIkpjik/FyplDPZ0LlRCUe2joTD"}]},"_npmUser":{"name":"bsheng","email":"supercarl87@gmail.com"},"directories":{},"maintainers":[{"name":"bsheng","email":"supercarl87@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/anyt-ads-cli_0.4.0_1780438246930_0.9349380477312492"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-02T22:10:46.735Z","0.4.0":"2026-06-02T22:10:47.207Z","modified":"2026-06-02T22:10:47.520Z"},"maintainers":[{"name":"bsheng","email":"supercarl87@gmail.com"}],"description":"AdAnt CLI — unified client for the AdAnt v1 API (skills, drive, api-keys, billing, agents, …)","keywords":["anyt-ads","adant","cli","skill","package-manager","ai","claude","claude-code","coding-agent"],"author":{"name":"AdAnt"},"license":"Artistic-2.0","readme":"# anyt-ads-cli — Unified CLI for AdAnt\n\n`anyt-ads-cli` is the command-line client for the AdAnt v1 API. It manages\nskills, notebooks, drive files, agents, API keys, billing, and more — all\nthrough a single `anyt-ads-cli` binary.\n\nSkills support **Claude Code**, **Cursor**, **Codex**, **Gemini CLI**,\n**Windsurf**, and [40+ more agents](#supported-agents).\n\n**Website:** [adant.up.railway.app](https://adant.up.railway.app)\n**Registry:** [adant.up.railway.app](https://adant.up.railway.app)\n\n## Install\n\n```bash\nnpm i @anytio/anyt-ads-cli\n```\n\nOr globally:\n\n```bash\nnpm i -g @anytio/anyt-ads-cli\n```\n\nThen run:\n\n```bash\nnpx @anytio/anyt-ads-cli --help\n```\n\nThe full surface includes `auth`, `config`, `skills`, `skill-lists`,\n`notebook`, `api-keys`, `credit`, `billing`, `drive`, `agents`, `artifacts`,\n`public-assets`, `favorites`, `media`, `session`, `admin`, `contact`, and\n`upgrade`. Run `npx @anytio/anyt-ads-cli <group> --help` for details on each.\n\n## Quick Start\n\n```bash\n# Authenticate (browser-based OAuth)\nnpx @anytio/anyt-ads-cli auth login\n\n# Check who you're logged in as\nnpx @anytio/anyt-ads-cli auth whoami\n\n# Initialize a new skill manifest\nnpx @anytio/anyt-ads-cli skills init\n\n# Add a skill from the registry\nnpx @anytio/anyt-ads-cli skills add @user/username/skill-name\n\n# List installed skills\nnpx @anytio/anyt-ads-cli skills list\n\n# Install all skills from the lockfile\nnpx @anytio/anyt-ads-cli skills install\n\n# Publish a skill to the registry\nnpx @anytio/anyt-ads-cli skills publish --access public --bump patch\n```\n\n## Skills\n\n### Add a Skill\n\n```bash\nnpx @anytio/anyt-ads-cli skills add <specifier> [--agent <agents>]\n```\n\nSupported specifier formats:\n\n```bash\n# Registry (with semver)\nnpx @anytio/anyt-ads-cli skills add @user/username/skill-name\nnpx @anytio/anyt-ads-cli skills add @user/username/skill-name@^2.0.0\nnpx @anytio/anyt-ads-cli skills add @org/myorg/team-skill@~1.2.0\n\n# GitHub shorthand\nnpx @anytio/anyt-ads-cli skills add owner/repo\nnpx @anytio/anyt-ads-cli skills add owner/repo/path/to/skill\n\n# Full GitHub URL (copy-paste from browser)\nnpx @anytio/anyt-ads-cli skills add https://github.com/owner/repo/tree/main/skills/web-design\n\n# GitHub with prefix and ref\nnpx @anytio/anyt-ads-cli skills add github:owner/repo@v1.0.0\nnpx @anytio/anyt-ads-cli skills add github:owner/repo/path/to/skill@main\n\n# Local path (development)\nnpx @anytio/anyt-ads-cli skills add ./my-local-skill\nnpx @anytio/anyt-ads-cli skills add file:../shared-skills\n\n# Well-known URL (RFC 8615 discovery)\nnpx @anytio/anyt-ads-cli skills add https://acme.com\n```\n\n### Common Skill Commands\n\n| Command | Description |\n|---------|-------------|\n| `npx @anytio/anyt-ads-cli skills add <specifier...>` | Add and install skills |\n| `npx @anytio/anyt-ads-cli skills install [specifiers...]` | Install from lockfile or add packages (alias: `i`) |\n| `npx @anytio/anyt-ads-cli skills remove <name>` | Remove an installed skill (alias: `rm`) |\n| `npx @anytio/anyt-ads-cli skills list` | List installed skills (alias: `ls`) |\n| `npx @anytio/anyt-ads-cli skills update` | Update to latest compatible versions |\n| `npx @anytio/anyt-ads-cli skills outdated [packages...]` | Check for outdated skills |\n| `npx @anytio/anyt-ads-cli skills search [query]` | Search the registry (alias: `find`) |\n| `npx @anytio/anyt-ads-cli skills audit` | Verify integrity of installed skills |\n| `npx @anytio/anyt-ads-cli skills link` | Recreate agent symlinks |\n| `npx @anytio/anyt-ads-cli skills init` | Create an `anyt.json` manifest |\n| `npx @anytio/anyt-ads-cli skills publish` | Publish skill to registry |\n| `npx @anytio/anyt-ads-cli skills unpublish <spec>` | Remove a published version (within 72h) |\n| `npx @anytio/anyt-ads-cli skills deprecate <spec>` | Mark a version as deprecated |\n| `npx @anytio/anyt-ads-cli skills access <spec>` | Change package visibility |\n| `npx @anytio/anyt-ads-cli skills version <bump>` | Bump version (major / minor / patch) |\n\n### Install Options\n\n| Option | Description |\n|--------|-------------|\n| `-g, --global` | Install to user home directory instead of project |\n| `--agent <agents>` | Comma-separated agents for symlinks (e.g., `claude-code,cursor`) |\n| `-y, --yes` | Skip prompts and use defaults |\n| `--frozen-lockfile` | CI mode — fail if lockfile is outdated |\n| `--dir <path>` | Install to a custom directory |\n| `--list <spec>` | Install all skills from a skill list |\n\n| Scope | Flag | Skills Location | Symlink Location |\n|-------|------|-----------------|------------------|\n| **Project** | (default) | `.anyt/skills/` | `./<agent>/skills/` |\n| **Global** | `-g` | `~/.anyt/skills/` | `~/<agent>/skills/` |\n\n## Authentication\n\n```bash\nnpx @anytio/anyt-ads-cli auth login                         # Browser-based OAuth\nnpx @anytio/anyt-ads-cli auth login --api-key <key>         # Authenticate with API key\nnpx @anytio/anyt-ads-cli auth logout                        # Clear stored credentials\nnpx @anytio/anyt-ads-cli auth whoami                        # Show current user info\n```\n\n## Configuration\n\n```bash\nnpx @anytio/anyt-ads-cli config show                        # Show resolved configuration\nnpx @anytio/anyt-ads-cli config init                        # Create a project-level .anytadsrc\nnpx @anytio/anyt-ads-cli config set-encryption-key @user/yourname <passphrase>\nnpx @anytio/anyt-ads-cli config get-encryption-key @user/yourname\nnpx @anytio/anyt-ads-cli config remove-encryption-key @user/yourname\n```\n\n### User Config (`~/.anytadsrc`)\n\n```ini\nregistry = https://adant.up.railway.app\nauthToken = sk_...\nusername = myuser\n```\n\n### Project Config (`.anytadsrc`)\n\n```ini\nregistry = https://custom-registry.example.com\n```\n\n### Lockfile (`anyt-lock.json`)\n\nTracks exact versions, resolved URLs, and integrity hashes for reproducible\ninstalls.\n\n## Publishing Skills\n\n```bash\nnpx @anytio/anyt-ads-cli skills publish --access public                       # Public release\nnpx @anytio/anyt-ads-cli skills publish --access private                      # Private (Pro)\nnpx @anytio/anyt-ads-cli skills publish --access team --org myorg             # Team-only\nnpx @anytio/anyt-ads-cli skills publish --access public --bump patch          # Bump and publish\n```\n\n`--access` is required (`public`, `private`, or `team`). `--access team`\nrequires `--org`. Public publishes are irreversible.\n\nBefore uploading, the CLI shows a preview of included files and the package\nsize. Max package size is **10MB**.\n\n### Versioning\n\n```bash\nnpx @anytio/anyt-ads-cli skills version major               # 1.0.0 -> 2.0.0\nnpx @anytio/anyt-ads-cli skills version minor               # 1.0.0 -> 1.1.0\nnpx @anytio/anyt-ads-cli skills version patch               # 1.0.0 -> 1.0.1\nnpx @anytio/anyt-ads-cli skills version patch --dry-run     # Preview without writing\n```\n\n## Creating a Skill\n\nA skill is a directory containing at minimum a `SKILL.md`:\n\n```markdown\n---\nname: my-skill\ndescription: A helpful skill that does X\n---\n\n# My Skill\n\nInstructions for the agent to follow when this skill is activated.\n```\n\nFor publishing, also include an `anyt.json` (created with `npx @anytio/anyt-ads-cli skills init`):\n\n```json\n{\n  \"name\": \"@user/myusername/my-skill\",\n  \"version\": \"1.0.0\",\n  \"description\": \"A helpful skill for…\",\n  \"files\": [\"anyt.json\", \"SKILL.md\"]\n}\n```\n\n## Ignoring Files (`.anytignore`)\n\nControl which files are excluded when publishing:\n\n```\n# .anytignore\n*.test.ts\n__tests__/\n.env*\n*.log\n```\n\n- If `.anytignore` exists, use it for ignore patterns.\n- Otherwise, fall back to `.gitignore` if present.\n- Always ignores `node_modules`, `.git`, and `.anyt-publish/`.\n\n## Directory Structure\n\n```\nproject/\n├── anyt.json               # Manifest with dependencies\n├── anyt-lock.json          # Lockfile (version pinning + integrity)\n├── .anytadsrc                 # Project config (optional)\n├── .anyt/\n│   ├── skills/                  # Installed skills (central store)\n│   │   ├── username/            # @user/<username>/<name>\n│   │   │   └── skillname/SKILL.md\n│   │   ├── _org/                # @org/<orgname>/<name>\n│   │   ├── _github-registry/    # @github/<owner>/<repo>/<name>\n│   │   ├── _wellknown/          # Well-known URL skills\n│   │   └── _local/              # Local skill symlinks\n│   └── cache/              # Tarball cache\n├── .claude/skills/         # Symlinks for Claude Code (and other agents)\n└── .cursor/skills/         # Symlinks for Cursor (if configured)\n```\n\n## Brain Sessions (`session`)\n\nDrive a brain chat session end-to-end — create, send turns, browse the\nmessage history, and download artifacts:\n\n```bash\n# Discover skills\nnpx @anytio/anyt-ads-cli session catalog\n\n# Start a session\nnpx @anytio/anyt-ads-cli session create --skill brain-general --title \"exploration\"\n\n# Send a turn (streams thinking, tool calls, and the assistant's reply)\nnpx @anytio/anyt-ads-cli session chat --session_id <id> \"say hello\"\n\n# Inspect history and artifacts\nnpx @anytio/anyt-ads-cli session list\nnpx @anytio/anyt-ads-cli session messages --session_id <id>\nnpx @anytio/anyt-ads-cli session artifacts --session_id <id>\nnpx @anytio/anyt-ads-cli session artifacts get <artifact-id> --out ./out.md\n\n# Manage attached skills\nnpx @anytio/anyt-ads-cli session skills --session_id <id>\nnpx @anytio/anyt-ads-cli session skills add @user/alice/research --session_id <id>\nnpx @anytio/anyt-ads-cli session skills remove brain-doc --session_id <id>\n```\n\nThe CLI talks to brain through the unified server (`<registry>/api/app/brain`)\nusing your `sk_*` API key — so the same commands work against your local stack\nor AdAnt. Set `ANYT_BRAIN_URL` to hit a brain HTTP port directly (for\nbrain-only debugging — artifacts and credit metering require the proxy).\n\n## Other Command Groups\n\n```bash\nnpx @anytio/anyt-ads-cli notebook upload notebook.anyt.md     # Notebook management\nnpx @anytio/anyt-ads-cli notebook list\n\nnpx @anytio/anyt-ads-cli drive folders list                   # AI Drive (file storage)\nnpx @anytio/anyt-ads-cli drive upload <file>\n\nnpx @anytio/anyt-ads-cli api-keys list                        # API key management\nnpx @anytio/anyt-ads-cli api-keys create \"ci-bot\"\n\nnpx @anytio/anyt-ads-cli billing subscription                 # Stripe billing\nnpx @anytio/anyt-ads-cli billing portal\n\nnpx @anytio/anyt-ads-cli agents list                          # Brain agent templates\nnpx @anytio/anyt-ads-cli artifacts list                       # Brain artifacts (all sessions)\nnpx @anytio/anyt-ads-cli favorites list                       # Favorites\nnpx @anytio/anyt-ads-cli media image generate                 # Image generation\n\nnpx @anytio/anyt-ads-cli upgrade                              # Self-update anyt-ads-cli\n```\n\nRun `npx @anytio/anyt-ads-cli <group> --help` for the full surface.\n\n## CI/CD Integration\n\n```bash\n# Set API key via environment variable\nexport ANYT_API_KEY=sk_ci_key\n\n# Install with frozen lockfile (fails if lockfile outdated)\nnpx @anytio/anyt-ads-cli skills install --frozen-lockfile\n\n# Audit installed skills\nnpx @anytio/anyt-ads-cli skills audit --json\n```\n\n## Environment Variables\n\n| Variable | Description |\n|----------|-------------|\n| `ANYT_REGISTRY_URL` | Override the default registry URL |\n| `ANYT_API_KEY` | API key for authentication |\n| `ANYT_WEB_URL` | Override the web app URL (used by `auth login`) |\n| `ANYT_BRAIN_URL` | Override the brain base URL for `session …` (bypasses the proxy; direct-to-brain only) |\n| `ANYT_DEBUG` | Enable debug logging |\n| `ANYT_ENCRYPTION_KEY_<SCOPE>` | Encryption key for a scope (e.g., `ANYT_ENCRYPTION_KEY_USER_ALICE`) |\n| `ANYT_NO_UPDATE_CHECK` | Disable the background update notifier |\n| `GITHUB_TOKEN` | GitHub token for private repos and higher rate limits |\n\nConfiguration resolves in priority order:\n\n1. Environment variables (highest)\n2. Project config (`.anytadsrc` in project directory)\n3. User config (`~/.anytadsrc`)\n4. Defaults (lowest)\n\n## Self-Update\n\n```bash\nnpx @anytio/anyt-ads-cli upgrade\n```\n\nAuto-detects your package manager (pnpm, npm, yarn, bun). The CLI also\nchecks for updates every 24 hours and notifies you when a newer version is\navailable. Set `ANYT_NO_UPDATE_CHECK=1` to disable.\n\n## Supported Agents\n\n| Agent | `--agent` value | Skills Directory |\n|-------|----------------|------------------|\n| AdaL | `adal` | `.adal/skills/` |\n| Amp | `amp` | `.agents/skills/` |\n| Antigravity | `antigravity` | `.agent/skills/` |\n| Augment | `augment` | `.augment/skills/` |\n| Claude Code | `claude-code` | `.claude/skills/` |\n| Cline | `cline` | `.agents/skills/` |\n| CodeBuddy | `codebuddy` | `.codebuddy/skills/` |\n| Codex | `codex` | `.agents/skills/` |\n| Command Code | `command-code` | `.commandcode/skills/` |\n| Continue | `continue` | `.continue/skills/` |\n| Cortex Code | `cortex` | `.cortex/skills/` |\n| Crush | `crush` | `.crush/skills/` |\n| Cursor | `cursor` | `.agents/skills/` |\n| Droid | `droid` | `.factory/skills/` |\n| Gemini CLI | `gemini-cli` | `.agents/skills/` |\n| GitHub Copilot | `github-copilot` | `.agents/skills/` |\n| Goose | `goose` | `.goose/skills/` |\n| iFlow CLI | `iflow-cli` | `.iflow/skills/` |\n| Junie | `junie` | `.junie/skills/` |\n| Kilo Code | `kilo` | `.kilocode/skills/` |\n| Kimi Code CLI | `kimi-cli` | `.agents/skills/` |\n| Kiro CLI | `kiro-cli` | `.kiro/skills/` |\n| Kode | `kode` | `.kode/skills/` |\n| MCPJam | `mcpjam` | `.mcpjam/skills/` |\n| Mistral Vibe | `mistral-vibe` | `.vibe/skills/` |\n| Mux | `mux` | `.mux/skills/` |\n| Neovate | `neovate` | `.neovate/skills/` |\n| OpenClaw | `openclaw` | `skills/` |\n| OpenCode | `opencode` | `.agents/skills/` |\n| OpenHands | `openhands` | `.openhands/skills/` |\n| Pi | `pi` | `.pi/skills/` |\n| Pochi | `pochi` | `.pochi/skills/` |\n| Qoder | `qoder` | `.qoder/skills/` |\n| Qwen Code | `qwen-code` | `.qwen/skills/` |\n| Replit | `replit` | `.agents/skills/` |\n| Roo Code | `roo` | `.roo/skills/` |\n| Trae | `trae` | `.trae/skills/` |\n| Trae CN | `trae-cn` | `.trae/skills/` |\n| Universal | `universal` | `.agents/skills/` |\n| Windsurf | `windsurf` | `.windsurf/skills/` |\n| Zencoder | `zencoder` | `.zencoder/skills/` |\n\n## License\n\nThis project is licensed under [The Artistic License 2.0](LICENSE), the same\nlicense used by npm.\n\n<!-- @doc-sync: edd2dc0 | 2026-05-29 14:11 -->\n","readmeFilename":"README.md","_rev":"1-94c7eb7b6d4dead37f44e7761ba8442a"}