Run your first Agent Turn

Install Lenso Agent, authenticate, check the local App, and run interactive and headless Turns.

This path uses the released Lenso Agent binaries. You will authenticate once, check the installed App, open the interactive terminal surface, and run the same App non-interactively. A Rust toolchain is not required.

1. Install Lenso Agent

Download the pinned installer, review it, then install the interactive Agent and management CLI. Version 0.1.0 supports Apple silicon on macOS 15 or later and x86-64 Linux:

curl --fail --location \
  https://github.com/LioRael/lenso-agent/releases/download/v0.1.0/install.sh \
  --output /tmp/lenso-agent-install.sh
less /tmp/lenso-agent-install.sh
sh /tmp/lenso-agent-install.sh --version 0.1.0

2. Authenticate and check the App

lenso-agent-cli auth login
lenso-agent-cli profiles install coding
lenso-agent-cli doctor --json

The default App uses the direct Codex Model with the default ChatGPT Profile. Authentication and durable state live under the global Agent Home, not the Workspace you ask the Agent to inspect. doctor --json reports actionable setup failures before the first Turn.

3. Start the TUI

Run this command from the Workspace you want the Agent to use:

lenso-agent --profile code

Submit a small read-only request such as:

Summarize this workspace README.

You now have a complete Agent App: model access, a durable Session, a terminal surface, and the base Plugin selection owned by the Host.

4. Run a headless Turn

lenso-agent-cli --profile code "Summarize this workspace README."

The TUI and headless command are two surfaces over the same Agent product. A surface does not own a second Plugin graph.

Develop the Agent itself

Clone and build the repository only when you need to change the Agent’s Rust implementation:

git clone https://github.com/LioRael/lenso-agent.git
cd lenso-agent
cargo test --workspace

The repository README documents the source-development surfaces and release lifecycle.

Next