---
title: Run your first Agent Turn
description: 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:

```sh
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

```sh
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:

```sh
lenso-agent --profile code
```

Submit a small read-only request such as:

```text
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

```sh
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:

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

The repository [README](https://github.com/LioRael/lenso-agent#readme) documents
the source-development surfaces and release lifecycle.

## Next

<CardGroup>
  <Card title="Learn the mental model" href="/docs/agent/mental-model" description="Separate Agent Home, Workspace, Profile, Session, Turn, and Generation." />
  <Card title="Choose a Profile" href="/docs/agent/profiles-and-tools" description="Select the smallest Tool authority for the work." />
  <Card title="Add your first Tool" href="/docs/agent/first-app" description="Build, install, run, disable, and remove one Tool Plugin." />
</CardGroup>