CLI Reference

The agentend CLI is built with Typer and provides commands for scaffolding projects, running the server, inspecting fleet configuration, and checking memory status.

`agentend init`

Scaffold a new Agentend project. Creates a project directory with all the files you need to start building.

agentend init <name> [--python-version 3.11]

Argument / Option	Default	Description
name	my-agent	Project name (used as directory name)
--python-version	3.11	Python version for the Dockerfile base image

Generated files:

•app.py — Application entry point with uvicorn
•fleet.yaml — Fleet, memory, and infrastructure configuration
•requirements.txt — Python dependencies
•Dockerfile — Container definition
•.env.example — Environment variable template (DATABASE_URL, REDIS_URL, JWT_SECRET, etc.)

`agentend serve`

Start the Agentend server. Loads configuration from the project directory and runs a FastAPI application with uvicorn.

agentend serve [--host 0.0.0.0] [--port 8000] [--reload] [--workers 1]

Option	Default	Description
--host	0.0.0.0	Host address to bind to
--port	8000	Port number to listen on
--reload	false	Enable auto-reload on file changes (development)
--workers	1	Number of uvicorn worker processes

`agentend fleet`

Display the current fleet configuration. Reads fleet.yaml from the current directory and prints a summary of agents, workers, and their settings.

agentend fleet

Example output:

Fleet Configuration:
  Name: default
  Version: 1
  Description: Default agentend fleet configuration

Agents (1):
  - main-agent
    * semantic_search
    * document_ingestion
    * memory_management

Workers (1):
  - executor (2 instances)
    Memory: 512MB
    Timeout: 300s

`agentend memory`

Show memory status and statistics. Connects to the configured Redis instance and reports usage, cache entries, active sessions, and budget tracking keys.

agentend memory

Example output:

Memory Status:
  Used: 2.45M
  Peak: 3.10M
  RSS: 4.20M

Cache Stats:
  Total Keys: 142
  Cache Entries: 85
  Active Sessions: 12
  Budget Tracking Keys: 45

Requires a running Redis instance. The Redis URL is read from the REDIS_URL environment variable (default: redis://localhost:6379).

`agentend version`

Print the installed Agentend version.

agentend version
# agentend 0.1.0-alpha