Avisyn

Avisyn is the official Avisyn user-level Skill for Claude Code, Codex, and OpenClaw. Query models, manage tokens, view groups, check balance, and ask Avisyn usage questions directly inside your AI coding workflow.

What is Avisyn-skills?

Avisyn-skills is the official AI editor Skill plugin from Avisyn. Skills are a lightweight extension protocol that enables AI coding assistants — such as Claude Code, Codex, OpenClaw, Cursor, Windsurf, and Cline — to call Avisyn endpoints directly from within the editor, performing model queries, token management, balance checks, and answering Avisyn deployment, configuration, and API usage questions without ever leaving your coding environment.

GitHub Repository: github.com/QuantumNous/skills

It now also works inside OpenClaw, so you can run /Avisyn commands for models, tokens, groups, and balance, and ask Avisyn usage questions without leaving your agent workflow.

Why Use Skills

During everyday AI development, developers frequently switch between their editor and the Avisyn management dashboard — checking available models, creating API tokens, inspecting balance, adjusting group quotas. These context switches disrupt coding flow.

What Avisyn-skills solves:

Zero context-switching: Issue natural language commands directly in Claude Code, Codex, OpenClaw, or other AI IDEs — no browser or admin panel needed
Built-in help: Ask about Avisyn deployment, configuration, groups, and API call formats directly from your coding workflow
Security-first design: Keys are never shown in plain text; token copy and injection use secure channels (sk- prefixed keys never appear in terminal output or logs)
Instant setup: A single npx command handles installation; runtime auto-detection (Bun / Node.js / Deno)
Cross-editor compatibility: Works with any AI editor or coding assistant that implements the Skills protocol

Supported AI Editors

Avisyn-skills works with the following AI coding tools:

AI Editor / Coding Assistant	Type	Notes
Claude Code	Terminal AI programming assistant	Official Anthropic CLI
OpenClaw	Self-hosted AI assistant platform	Supports Skills-based `/Avisyn` command workflows
Cursor	AI-native code editor	VS Code based
Windsurf	AI code editor	By Codeium
Cline	VS Code AI extension	Open-source AI coding agent
Codex CLI	Terminal AI programming assistant	Official OpenAI CLI

Any tool that supports the Skills protocol can use Avisyn-skills.

Commands Reference

Below is the complete list of commands provided by Avisyn-skills. These commands interact with the Avisyn REST API to query and manage resources on your Avisyn instance.

Query Commands

Command	Description	Use Case
`/Avisyn models`	List available AI models	View all models configured on your Avisyn instance (OpenAI, Claude, Gemini, etc.)
`/Avisyn groups`	List user groups	View your account's groups with quota and rate multiplier settings
`/Avisyn balance`	Show account balance	Real-time query of current user's balance and usage

Token Management Commands

Command	Description	Use Case
`/Avisyn tokens`	List API tokens	View all created tokens (keys shown masked, e.g. `sk-reHR**********OspA`)
`/Avisyn create-token <name> [--group=xxx]`	Create new API token	Generate independent API keys for different apps or projects
`/Avisyn switch-group <token_id> <group>`	Change token's group	Modify token group to adjust model access permissions and rate multipliers
`/Avisyn copy-token <token_id>`	Copy key to clipboard	Securely copy the real key to system clipboard (key never displayed in terminal)
`/Avisyn apply-token <token_id> <file>`	Inject key into config file	Securely write token key into project config files (e.g. `.env`) via placeholder replacement

Help Command

Command	Description	Use Case
`/Avisyn help <question>`	Ask about Avisyn	Get help on Avisyn deployment, configuration, API call formats, and more

Installation & Configuration

Install Avisyn-skills

One-line installation via npx:

npx skills add https://github.com/QuantumNous/skills --skill Avisyn

This pulls the latest Skill definition from the GitHub repository and installs it into your editor environment.

Set Environment Variables

Avisyn-skills requires three environment variables to connect to your Avisyn instance. Add them to your shell profile:

# ~/.bashrc or ~/.zshrc
export Avisyn_BASE_URL=https://<your-Avisyn-domain>
export Avisyn_ACCESS_TOKEN=your-access-token
export Avisyn_USER_ID=1

Variable	Description	Example
`Avisyn_BASE_URL`	Avisyn service URL	`https://api.example.com`
`Avisyn_ACCESS_TOKEN`	Admin or user access token	From "Personal Settings → Account → Security → System Access Token"
`Avisyn_USER_ID`	User ID	`1` (admin default is 1)

You can also create a .env file in your project root. Make sure .env is listed in .gitignore to prevent key leaks.

Start Using

Once installed, type /Avisyn commands in any Skills-compatible AI editor. For example:

Type /Avisyn models to list available models
Type /Avisyn balance to check your current balance
Type /Avisyn create-token my-app to create a new token named my-app
Type /Avisyn help how do I configure groups and tokens? to ask Avisyn usage questions directly
In OpenClaw, you can also run /Avisyn models, /Avisyn balance, and token commands directly in your agent workflow

Runtime Requirements

Avisyn-skills requires one of the following JavaScript runtimes (auto-detected at startup):

Runtime	Version	Recommendation
Bun	Latest	Recommended (fastest)
Node.js	>= 18	Widely supported
Deno	Latest	Optional

Security

Avisyn-skills has multiple layers of security built in to protect your API keys:

Token listings only show masked keys (e.g. sk-reHR**********OspA) — real keys never appear in terminal output
copy-token copies the key to the system clipboard only, never displaying it in any output
apply-token uses placeholder replacement to inject keys, never exposing raw key content
All sk- prefixed key values are strictly protected throughout the entire execution flow

Learn More

Avisyn-skills is under active development — commands and features may change with updates. Refer to the repository README for the latest information and changelog:

GitHub Repository: github.com/QuantumNous/skills
Avisyn Website: www.Avisyn.ai
Avisyn GitHub: github.com/QuantumNous/new-api

On this page