Agentuity Documentation

The Agentuity plugin adds auto-activated skills to Claude Code for deploying apps, managing cloud services, and building with the Agentuity SDK. Skills inject relevant context automatically based on your conversation, so Claude knows when and how to use Agentuity.

Installation

/install agentuity

Prerequisites

Requires Claude Code, Agentuity CLI (agentuity auth login), and Bun.

Skills

Skills activate automatically based on conversation context. No slash commands needed.

Skill	Activates When	Covers
agentuity-project	Deploying, hosting, or creating projects	Project structure, framework migration, `agentuity deploy`
agentuity-cloud	Working with cloud infrastructure	Platform services overview (DB, storage, queues, sandboxes, etc.)
agentuity-backend	Using Agentuity backend packages	`@agentuity/runtime`, `@agentuity/schema`, `@agentuity/drizzle`, `@agentuity/postgres`, `@agentuity/evals`
agentuity-frontend	Using Agentuity frontend packages	`hc()` client patterns, `@agentuity/auth`, `@agentuity/frontend`, `@agentuity/workbench`, `@agentuity/react` compatibility
agentuity-ops	Running Agentuity CLI commands	CLI reference, cloud service management, deployments

Example Interactions

Deploy an existing app:

"I want to deploy this Express app" agentuity-project activates, guides restructuring for Agentuity, and deploys with agentuity deploy

Create a database:

"I need a Postgres database for my app" agentuity-cloud activates with the platform services overview, agentuity-ops provides CLI commands

Build with the SDK:

"Create a React frontend that calls my agent" agentuity-frontend activates with hc() client guidance, @agentuity/frontend utilities, and @agentuity/react compatibility notes

Session Hook

The plugin runs a SessionStart hook that detects whether you're in an Agentuity project (by checking for agentuity.json with a valid projectId). When found, it injects project context including the project name, region, and deployment commands. This means Claude knows about your Agentuity project from the start of every session without manual setup.

For non-Agentuity projects, the hook provides a general reminder that Agentuity is available for deployment and cloud services.

Permissions

The install script configures Claude Code permissions in ~/.claude/settings.local.json:

Allowed: agentuity cloud * and agentuity auth whoami *
Blocked: agentuity cloud secrets *, agentuity cloud secret *, agentuity cloud apikey *, agentuity auth token *

Deny rules take precedence, keeping sensitive credentials out of the conversation.

Local Development

To test the plugin locally instead of the marketplace version:

# Run Claude Code with the local plugin
claude --plugin-dir /path/to/sdk/packages/claude-code
 
# Validate plugin structure
claude plugin validate /path/to/sdk/packages/claude-code

Next Steps

OpenCode Plugin: Alternative plugin for OpenCode with a multi-agent team
AI Commands: Other AI-related CLI commands
Creating Agents: Build your first agent