Skip to content

Getting Started

Pygent is a simple agentic CLI for coding tasks. It executes commands in Docker when available, and locally when Docker is not available.

Installation

pip install pygent

If you want Docker SDK integration:

pip install pygent[docker]

From source:

pip install -e .
# optional
pip install -e .[docker]

First interactive session

pygent

Useful startup options:

  • --docker / --no-docker
  • --config path/to/pygent.toml
  • --cwd (use current directory as workspace)
  • --confirm-bash / --no-confirm-bash
  • --ban-cmd CMD (repeatable)
  • --load DIR (resume snapshot)

Inside the session:

  • /help and /help <cmd>
  • /cmd <command>
  • /cp <source> [destination]
  • /tools, /banned, /confirm-bash on|off
  • /save <dir> and /exit

Programmatic usage

from pygent import Agent

ag = Agent()
ag.step("echo 'Hello World'")
ag.runtime.cleanup()

Next steps