CLI USAGE - Autogpt — ContextQMD

CLI Documentation

This document describes how to interact with the project's CLI (Command Line Interface). It includes the types of outputs you can expect from each command. Note that the agents stop command will terminate any process running on port 8000.

1. Entry Point for the CLI

Running the ./run command without any parameters will display the help message, which provides a list of available commands and options. Additionally, you can append --help to any command to view help information specific to that command.

./run

Output:

Usage: cli.py [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  agent     Commands to create, start and stop agents
  benchmark  Commands to start the benchmark and list tests and categories
  setup      Installs dependencies needed for your system.

If you need assistance with any command, simply add the --help parameter to the end of your command, like so:

./run COMMAND --help

This will display a detailed help message regarding that specific command, including a list of any additional options and arguments it accepts.

2. Setup Command

./run setup

Output:

Setup initiated
Installation has been completed.

This command initializes the setup of the project.

3. Agents Commands

a. List All Agents

./run agent list

Output:

Available agents: 🤖
        🐙 forge
        🐙 autogpt

Lists all the available agents.

b. Create a New Agent

./run agent create my_agent

Output:

🎉 New agent 'my_agent' created and switched to the new directory in agents folder.

Creates a new agent named 'my_agent'.

c. Start an Agent

./run agent start my_agent

Output:

... (ASCII Art representing the agent startup)
[Date and Time] [forge.sdk.db] [DEBUG] 🐛  Initializing AgentDB with database_string: sqlite:///agent.db
[Date and Time] [forge.sdk.agent] [INFO] 📝  Agent server starting on http://0.0.0.0:8000

Starts the 'my_agent' and displays startup ASCII art and logs.

d. Stop an Agent

./run agent stop

Output:

Agent stopped

Stops the running agent.

4. Benchmark Commands

a. List Benchmark Categories

./run benchmark categories list

Output:

Available categories: 📚
        📖 code
        📖 safety
        📖 memory
        ... (and so on)

Lists all available benchmark categories.

b. List Benchmark Tests

./run benchmark tests list

Output:

Available tests: 📚
        📖 interface
                🔬 Search - TestSearch
                🔬 Write File - TestWriteFile
        ... (and so on)

Lists all available benchmark tests.

c. Show Details of a Benchmark Test

./run benchmark tests details TestWriteFile

Output:

TestWriteFile
-------------

        Category:  interface
        Task:  Write the word 'Washington' to a .txt file
        ... (and other details)

Displays the details of the 'TestWriteFile' benchmark test.

d. Start Benchmark for the Agent

./run benchmark start my_agent

Output:

(more details about the testing process shown whilst the test are running)
============= 13 failed, 1 passed in 0.97s ============...

Displays the results of the benchmark tests on 'my_agent'.