# xagent-pi
Local XAGENT client that manages projects and conversations, drives the Pi
coding agent, serves the embedded responsive web UI, and registers with an
`xagent-service` relay.
## Requirements
- Rust and Cargo
- Node.js 20 or newer and npm (the embedded web UI is built during installation)
- Pi coding agent available as `pi`
## Install
```bash
cargo install xagent-pi
```
Create `~/.xagent/setting.json`:
```json
{
"username": "your-name",
"password": "your-password",
"serviceUrl": "wss://your-service.example",
"cwd": "/absolute/path/to/workspace"
}
```
Then register the account and start in the background:
```bash
xagent-pi start
xagent-pi status
```
Use `xagent start-sync` for foreground execution. Runtime data, logs, and the
PID file are stored under `~/.xagent`.
Project source and complete documentation:
<https://github.com/luodeb/xagent>