wehub-resource-sync
58 lines
1.8 KiB
Markdown
58 lines
1.8 KiB
Markdown
# Cline Core CLI Agent
|
|
|
|
An interactive terminal chat agent powered by the `ClineCore` runtime. This example is similar in spirit to [`cli-agent`](../cli-agent), but uses stateful ClineCore sessions and built-in runtime tools instead of the stateless `Agent` class, to leverage Cline's internal agent harness.
|
|
|
|
## Getting started
|
|
|
|
Install dependencies:
|
|
|
|
```bash
|
|
bun install
|
|
bun run build:sdk
|
|
```
|
|
|
|
Set an API key:
|
|
|
|
```bash
|
|
export CLINE_API_KEY="sk_..."
|
|
```
|
|
|
|
Run:
|
|
|
|
```bash
|
|
bun dev
|
|
```
|
|
|
|
Type any message at the `you:` prompt to see a streaming response. Type `exit` to quit.
|
|
|
|
## Optional model configuration
|
|
|
|
The example defaults to Cline's gateway provider and Claude Sonnet:
|
|
|
|
```bash
|
|
export CLINE_PROVIDER_ID="cline"
|
|
export CLINE_MODEL_ID="anthropic/claude-sonnet-4.6"
|
|
```
|
|
|
|
## What it does
|
|
|
|
- Creates a local `ClineCore` runtime with `ClineCore.create()`
|
|
- Starts one interactive session with `cline.start()`
|
|
- Sends each user turn with `cline.send({ sessionId, prompt })`
|
|
- Streams `agent_event` text to stdout as the assistant responds
|
|
- Logs tool calls and tool results inline
|
|
- Uses ClineCore's built-in tools instead of defining custom tools
|
|
- Calls `cline.stop()` and `cline.dispose()` during shutdown
|
|
|
|
## Concepts demonstrated
|
|
|
|
- Stateful sessions with `ClineCore`
|
|
- Multi-turn conversation using a single `sessionId`
|
|
- `CoreSessionEvent` subscription via `cline.subscribe()`
|
|
- Built-in runtime tools (`read_files`, `search_codebase`, `run_commands`, etc.)
|
|
- Basic tool policies: file reads/search are auto-approved, other tools request approval
|
|
|
|
## Notes
|
|
|
|
Use this example when you want the full ClineCore runtime with sessions, persistence, and built-in tools. For the smallest possible SDK example, see [quickstart](../quickstart). For the lightweight stateless runtime, see [cli-agent](../cli-agent).
|