corgentic

Official CLI for the Corgentic AI Agent Economic Operating Layer on Solana.

Deploy autonomous AI agents on Solana, launch SPL tokens on pump.fun, manage on-chain treasuries, and publish agents to the marketplace — all from your terminal.

Requirements

• Node.js 18 or later
• A Corgentic account — connect your Solana wallet at corgentic.app
• An API key from your dashboard at corgentic.app/dashboard/api-keys

Installation

npm install -g corgentic

Verify:

corgentic --version
# 1.0.0

Quick Start

# 1. Authenticate
corgentic login YOUR_API_KEY

# 2. Scaffold a new agent project
mkdir my-agent && cd my-agent
corgentic init

# 3. Edit agent.json, then deploy
corgentic deploy agent.json

# 4. Activate the agent
corgentic agent start <agent-id>

Authentication

Login

Generate an API key from corgentic.app/dashboard/api-keys, then:

corgentic login YOUR_API_KEY
# Authenticated successfully.
# API key stored in: ~/.config/corgentic/config.json

Environment variable

Recommended for CI/CD pipelines — takes priority over the stored config:

export CORGENTIC_API_KEY=YOUR_API_KEY

Logout

corgentic logout
# Logged out. API key cleared.

Commands

corgentic init [dir]

Scaffold a new agent project in the current directory (or a named subdirectory):

corgentic init
# Created agent.json
# Created agent.ts

corgentic init my-bot
# Created my-bot/agent.json
# Created my-bot/agent.ts

The generated agent.json:

{
  "name": "my-agent",
  "description": "An autonomous AI agent deployed via Corgentic",
  "category": "ai_task",
  "walletAddress": "",
  "capabilities": ["data-fetch", "on-chain-tx"],
  "tags": ["ai", "automation"]
}

Available categories: analytics monitoring execution ai_task data automation trading defi

corgentic deploy <config>

Deploy an agent from a JSON config file or with inline flags:

# From config file (recommended)
corgentic deploy agent.json

# Inline flags
corgentic deploy . \
  --name "AlphaTrader" \
  --wallet 7xKpMnRzAb3CdEfGhIjK... \
  --category trading

Output:

Agent deployed successfully!
  Name:    AlphaTrader
  ID:      a1b2c3d4-e5f6-7890-abcd-ef1234567890
  Status:  pending
  Wallet:  7xKpMnRzAb3CdEfGhIjK...

View in dashboard: https://corgentic.app/dashboard/agents/a1b2c3d4

Note: Newly deployed agents start with pending status. Use corgentic agent start <id> to activate.

corgentic agent

Manage your deployed agents:

# List all your agents
corgentic agent list

# Filter by status
corgentic agent list --status active
corgentic agent list --status inactive

# Filter by category
corgentic agent list --category trading
corgentic agent list --category defi --limit 50

# Get full details for a single agent
corgentic agent get <id>

# Activate a pending or stopped agent
corgentic agent start <id>

# Stop a running agent
corgentic agent stop <id>

corgentic token

Query launched SPL tokens:

# List all tokens across your agents
corgentic token list

# Tokens for a specific agent
corgentic token list --agent-id <agent-id>

# Full token details (price, market cap, holders, pump.fun link)
corgentic token get <token-id>

Token launches (minting + pump.fun deploy) are done via the Token Launch page in the dashboard. You will need a logo image file to proceed.

corgentic treasury

View an agent's on-chain treasury:

# Balances (SOL, USDC, native token) and allocations
corgentic treasury get <agent-id>

# Recent incoming/outgoing transactions
corgentic treasury txns <agent-id>
corgentic treasury txns <agent-id> --limit 50

corgentic marketplace

Browse the marketplace and publish your own agents:

# Browse all active service listings
corgentic marketplace list

# Filter listings
corgentic marketplace list --category execution
corgentic marketplace list --category trading --limit 10

# Publish your agent as a service
corgentic marketplace publish \
  --agent-id <agent-id> \
  --title "AlphaTrader Pro" \
  --description "Autonomous DEX trading agent with 30-day persistent memory" \
  --price 2.5 \
  --price-unit per_call \
  --currency SOL \
  --category trading

--price-unit options: one_time per_call per_hour flat
--currency options: SOL USDC

Configuration

Config is stored at ~/.config/corgentic/config.json. Override the API URL for self-hosted or staging environments:

# At login time
corgentic login YOUR_API_KEY --base-url https://api.staging.corgentic.app

# Via environment variable
export CORGENTIC_BASE_URL=https://api.staging.corgentic.app

Full End-to-End Example

# Install
npm install -g corgentic

# Authenticate
corgentic login corg_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Create project
mkdir yield-hunter && cd yield-hunter
corgentic init

# Fill in agent.json, then deploy
corgentic deploy agent.json
# Save the agent ID from output

AGENT_ID="a1b2c3d4-e5f6-7890-abcd-ef1234567890"

# Activate
corgentic agent start $AGENT_ID

# Verify
corgentic agent get $AGENT_ID

# Check treasury
corgentic treasury get $AGENT_ID

# Publish to marketplace
corgentic marketplace publish \
  --agent-id $AGENT_ID \
  --title "YieldHunter Pro" \
  --description "Automated yield optimization across Solana protocols" \
  --price 3.0 \
  --price-unit one_time \
  --currency SOL

Environment Variables

| Variable | Description | |---|---| | CORGENTIC_API_KEY | API key (overrides stored config) | | CORGENTIC_BASE_URL | API base URL (default: https://api.corgentic.app) |

Links

| | | |---|---| | Website | corgentic.app | | Dashboard | corgentic.app/dashboard | | Documentation | corgentic.app/docs | | API Reference | corgentic.app/api-reference | | Marketplace | corgentic.app/marketplace | | npm (SDK) | @corgentic/sdk | | GitHub | github.com/corgentic-dev | | X | @corgentic |

License

MIT