CLI Command Reference

Agento provides a fast, instant-boot CLI entrypoint with focused subcommands for launching sessions, managing codebase guardrails, scaffolding plugins, and handling updates.

Syntax Overview

agento [command] [options]

---

Commands

agento (Interactive Workspace)

Launches the OpenTUI terminal interface in the current directory.

agento

If run inside a Git repository, Agento automatically binds to the project root and loads project-specific LINTO rules and configuration.

---

agento linto init [path]

Scaffolds a .linto/ directory containing starter rule definitions and creates linto.d.ts for authoring type-safe programmatic rules.

# Scaffold .linto/ in the current repository root
agento linto init

# Scaffold .linto/ in a specific target directory
agento linto init ./packages/core

---

agento plugin init <name> [targetDir]

Scaffolds a new Agento plugin with TypeScript configuration, starter AI SDK tools, pre-flight checks, human approval gates, developer documentation (README.md), and AI coding assistant rules (AGENTS.md).

# Scaffold in ./agento-plugin-postgres/
agento plugin init postgres

# Scaffold with scoped npm name in a custom directory
agento plugin init @myorg/agento-plugin-db ./plugins/db

Output:

Creating Agento plugin: @myorg/agento-plugin-db in ./plugins/db...

Created:
  + package.json
  + tsconfig.json
  + .gitignore
  + README.md
  + AGENTS.md
  + src/index.ts
  + src/tools/example.ts
  + src/subsystems/example.ts

---

agento update [--apply]

Checks the official release endpoint for binary updates.

# Check if an update is available
agento update

# Download and apply the update immediately
agento update --apply

---

agento version

Prints the current version of the installed Agento binary.

agento version

---

agento --help

Displays the command-line help menu and available options.

agento --help