Valley Agent

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

Prerequisites

• Bun runtime (required)
• Node.js 18+ (for npx)

Installation

Using npx (recommended)

npx valley-agent

Global Installation

npm install -g valley-agent
valley-agent

Usage

# Start with default port (3000)
npx valley-agent

# Start with custom port
npx valley-agent --port 8080

# Show help
npx valley-agent --help

Features

Web UI

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

API Endpoints

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

License

MIT