CLI command reference

Agento provides subcommands for launching sessions, managing LINTO guardrails, scaffolding plugins, and applying binary 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 binds to the project root and loads project-specific LINTO rules and configuration.

agento linto init [path]

Scaffolds a .linto/ directory with starter rule definitions and creates linto.d.ts for authoring 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] [--flavor standard|minimal|effect|mcp-bridge]

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

# Standard starter with custom tools, setup tasks, and approval gates
agento plugin init postgres

# Minimal single-file plugin
agento plugin init @myorg/quick-tools ./plugins/quick --flavor minimal

# Effect-native plugin
agento plugin init worker --flavor effect

# MCP server bridge plugin
agento plugin init postgres-mcp --flavor mcp-bridge

Output:

Creating Agento plugin: agento-plugin-postgres (standard flavor)
Target directory: ./agento-plugin-postgres

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