CleverAgents Core

CleverAgents is the Python-first migration of the Plandex automation platform. It provides a unified agents CLI, embedded runtime, and service orchestration tools that mirror the original Go workflows while embracing modern Python tooling.

Highlights

Unified CLI entry points: cleveragents and agents
Fast Typer/Click-based interface with parity for help/version behavior
Behavior-driven coverage via Behave and Robot Framework
Nox automation for linting, typing, testing, docs, builds, and benchmarks
MkDocs-powered documentation with CleverAgents branding

Quick Start

# clone the CleverAgents core repository
git clone https://git.cleverthis.com/cleveragents/core.git
cd core

# install dependencies
python -m venv .venv
source .venv/bin/activate
pip install -e .[tests,docs]

# verify the CLI
agents --help
agents --version

Developing

# run validation suites
nox -s format
nox -s lint
oxt -s typecheck
nox -s unit_tests
nox -s integration_tests

Documentation

nox -s docs
nox -s serve_docs

Tests

Behave feature scenarios live under features/ and Robot suites under robot/. Use the Nox sessions above to execute them in parity with the implementation plan.

1.2 KiB Raw Blame History