Valley Agent

AI Agent Server with Web UI, Scheduler, and Claude Code Integration.

Prerequisites

- Bun runtime (required)
- Node.js 18+ (for npx)
- Anthropic API key (set as ANTHROPIC_API_KEY environment variable)

Installation

$3

``bash
npx valley-agent
`

$3

`bash
npm install -g valley-agent
valley-agent
`

Usage

`bash


Start with default port (3000)

npx valley-agent

Start with custom port

npx valley-agent --port 8080

Show help

npx valley-agent --help
`

Features

$3

Access the web interface at http://localhost:8453:

- Chat: Interactive chat with AI agent
- Sessions: Manage multiple conversation sessions
- Settings: Configure CLAUDE.md and skills
- Scheduler: Create and manage scheduled tasks

$3

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | /api/sessions | List all sessions |
| POST | /api/sessions/:id/stop | Stop running session |
| GET | /api/scheduler/tasks | List scheduled tasks |
| POST | /api/scheduler/tasks | Create task |

Workspace

All data is stored in ~/.valley/:

`
~/.valley/
├── CLAUDE.md # Agent instructions
├── scheduler.json # Scheduled tasks
└── .claude/
└── skills/ # Custom skills
`

Environment Variables

| Variable | Description | Default |
|----------|-------------|---------|
| ANTHROPIC_API_KEY | Anthropic API key | Required |
| VALLEY_AGENT_PORT` | Server port | 3000 |

License

MIT