Skip to content

CLI and coding agents

AI coding agents work best when they understand the systems and tools available to them. The superglue CLI includes a skill that teaches agents how to authenticate, use sg commands, build tools, and investigate failures.

Install the CLI

Section titled “Install the CLI”

Install the CLI, sign in, and confirm the active account:

Terminal window
npm install -g @superglue/cli
sg login
sg whoami

For CI or another non-interactive environment, configure an API key instead:

Terminal window
export SUPERGLUE_API_KEY="your-api-key"
export SUPERGLUE_API_ENDPOINT="https://api.superglue.cloud"

See the CLI overview for authentication and usage, or the command reference for every available command.

Install the skill

Section titled “Install the skill”

Install the superglue skill for any supported coding agent:

Terminal window
npx skills add superglue-ai/cli

The installer detects supported agents automatically. To target one agent globally, run npx skills add superglue-ai/cli -g -a <agent>.

What the skill provides

Section titled “What the skill provides”
  • CLI commands, flags, and authentication patterns
  • Connection, tool, and execution schemas
  • Workflows for testing systems and investigating failed runs
  • Focused references for HTTP APIs, databases, file servers, transforms, and integrations

Add project context

Section titled “Add project context”

The skill teaches an agent how to use superglue. To make the agent also discover the current project setup, add a short instruction to AGENTS.md, CLAUDE.md, or your agent’s equivalent file:

## Using superglue


Before working with superglue:


1. Read the superglue skill and the references relevant to the task.
2. Confirm that the CLI is authenticated.
3. Run `sg system list` and `sg tool list` before building or changing anything.
4. Discover system and tool IDs instead of hardcoding them.

LLM-readable documentation

Section titled “LLM-readable documentation”

Agents that do not support skills can use llms.txt as a lightweight documentation index or llms-full.txt for the complete documentation in one file.

More resources

Section titled “More resources”