Skip to main content
Debug mode helps you understand the flow of execution and intermediate steps:
  • Inspect the messages sent to the model and the response it generates
  • Trace intermediate steps and monitor metrics like token usage and execution time
  • Inspect tool calls, errors, and their results

​
Debug Mode

To enable debug mode:
  1. Set debug_mode=True on your agent to enable it for all runs.
  2. Set debug_mode=True on the run method to enable it for a single run.
  3. Set the AGNO_DEBUG=True environment variable to enable debug mode globally.
from agno.agent import Agent
from agno.models.anthropic import Claude
from agno.tools.hackernews import HackerNewsTools

agent = Agent(
    model=Claude(id="claude-sonnet-4-5"),
    tools=[HackerNewsTools()],
    instructions="Write a report on the topic. Output only the report.",
    markdown=True,
    debug_mode=True,
    # debug_level=2, # Uncomment for more detailed logs
)

# Run agent and print response to the terminal
agent.print_response("Trending startups and products.")
Set debug_level=2 for more detailed logs.

​
Interactive CLI

Agno includes a pre-built interactive CLI that runs your Agent as a command-line application. Use it to test multi-turn conversations: 
from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.anthropic import Claude
from agno.tools.hackernews import HackerNewsTools

agent = Agent(
    model=Claude(id="claude-sonnet-4-5"),
    tools=[HackerNewsTools()],
    db=SqliteDb(db_file="tmp/data.db"),
    add_history_to_context=True,
    num_history_runs=3,
    markdown=True,
)

# Run agent as an interactive CLI app
agent.cli_app(stream=True)