agentuity-cli

Use when working with the Agentuity CLI itself: installation, authentication, profiles, JSON output, command discovery, schema inspection, non-interactive automation, structured input, and deciding which Agentuity command family to use.

Jump to install

Repository: agentuity/sdk
Last source activity: July 24, 2026 at 01:42
Detected SKILL.md language: English
Stars: 19
Forks: 2

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/agentuity/sdk --skill agentuity-cli

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

agentuity-cloud

Use when managing Agentuity Cloud from the terminal. Covers deployments, deployment logs, environment variables and secrets, regions, project resource linking, cloud resource commands, SSH, SCP, monitoring snapshots, and agent-friendly CLI workarounds.

2026-07-24

agentuity-project

Use when creating, importing, running, building, or deploying an Agentuity app. Covers framework-first project structure, agentuity.json, .env setup, agentuity dev, agentuity build, agentuity deploy, monorepo --dir usage, and deployment bundle inspection.

2026-07-24

agentuity-ai

Use when building model-backed Agentuity features, AI routes, structured output, chat, streaming, tool calling, or app-owned state and memory. Covers plain server functions, AIGatewayClient, provider SDK choices, validation, KV-backed history, and safe tool execution.

2026-06-25

View all from this repository

name	agentuity-cli
description	Use when working with the Agentuity CLI itself: installation, authentication, profiles, JSON output, command discovery, schema inspection, non-interactive automation, structured input, and deciding which Agentuity command family to use.
license	Apache-2.0
metadata	{"author":"agentuity","version":"1.0.0"}

Agentuity CLI

The agentuity CLI manages project setup, local development, deploys, cloud resources, auth, profiles, and agent-friendly command schemas. When unsure about flags or response shapes, ask the CLI instead of guessing.

First Checks

agentuity --version
agentuity auth whoami
agentuity --help

If the user is not authenticated:

agentuity auth login

Headless environments should use documented API-key environment variables or a configured profile. A first-class API-key login flow is tracked as an SDK issue; do not invent unsupported auth commands.

Command Discovery

Use these before guessing flags:

agentuity <command> --help
agentuity --help json
agentuity ai schema show
agentuity ai capabilities show
agentuity ai intro

Per-command schema:

Need	Command family	Skill
Create/import/run/build/deploy an app	`project`, `dev`, `build`, `deploy`	`agentuity-project`
Manage deployments, logs, env, resources, SSH	`cloud`	`agentuity-cloud`
Use service clients from app code	package installs	`agentuity-services`
Build model-backed features	AI Gateway and provider SDK commands	`agentuity-ai`
Add relational data	`cloud db`, `project add database`	`agentuity-database`
Add async work	`cloud queue`, `cloud schedule`, `cloud webhook`, `cloud task`	`agentuity-background-work`
Manage cloud coding sessions	`coder`	Agentuity Coder docs

Context	Prefer
Project	run from the app directory or pass `--dir` / `--project-id` / `--project-config`
Env files	global `--env <path>` (repeatable; later files override earlier keys)
Organization	pass `--org-id` or select it in auth/profile setup
Region	pass `--region` or select one before automation
Destructive commands	pass `--force` or `--confirm` when supported

Mistake	Better approach
Guessing CLI flags from memory	Run `agentuity <command> --help` or `--describe`
Parsing human tables in automation	Use `--json` and `--fields`
Relying on implicit org/region in CI	Pass `--org-id`, `--region`, and project context explicitly
Assuming every prompt is safe in non-TTY	Use explicit confirm/force flags where available
Teaching unsupported commands	Verify with help or schema output first

agentuity-cli

Install options

Review the source files

Agentuity CLI

First Checks

Command Discovery

Agentuity CLI

First Checks

Command Discovery

JSON and Structured Input

Command Families

Auth and Profiles

Non-Interactive Automation

Error Handling

Common Mistakes

Useful Docs

agentuity-cli

Source facts

Install options

Review the source files

More from this repository

Agentuity CLI

First Checks

Command Discovery

Agentuity CLI

First Checks

Command Discovery

JSON and Structured Input

Command Families

Auth and Profiles

Non-Interactive Automation

Error Handling

Common Mistakes

Useful Docs

More from this repository