v16-agents

KO | EN

gitlite — search

#python #react #typescript #android #machine-learning #rust #deep-learning #linux #nodejs #kubernetes #awesome-list #vue #ios #mcp

(★ 10)

Autonomous personal assistant for everyone

v16-agents Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">V16 Agents</h1>

Run hundreds of autonomous AI agents on your machine. Automate everything — code, workflows, ops, outreach, and more.

<code>npm install -g v16.ai && v16 connect</code>

"What if every repetitive task you do had an AI agent doing it for you, 24/7?"

<a href="https://v16.ai">Website</a> &nbsp;&middot;&nbsp;
 <a href="https://v16.ai/dashboard">Dashboard</a> &nbsp;&middot;&nbsp;
 <a href="#-install">Install</a> &nbsp;&middot;&nbsp;
 <a href="#-architecture">Architecture</a> &nbsp;&middot;&nbsp;
 <a href="#-contributing">Contributing</a>

---

### What people automate with V16

## What is this?

This repo is the **open-source local agent** for [V16](https://v16.ai) — autonomous AI agent orchestration that runs on your machine.

It runs a lightweight HTTP server on your machine. The V16 dashboard talks to it directly — no cloud relay, no WebSocket. Your API keys never leave your machine.

```
  v16.ai dashboard  ──HTTP──>  localhost:7160 (your machine)
                                     │
                                     ├─ Claude Code
                                     ├─ Codex
                                     ├─ Any CLI tool
                                     └─ Local filesystem, git, terminal
```

## What's inside

```
src/
├── cli/                 CLI commands (connect, login, run, agents, tools, status)
├── core/                HTTP server, config, logger, command router
├── handlers/            Execution handlers, status reporting, tool runner
├── scheduler/           Cron-based scheduling — syncs with backend, runs locally
├── templates/           Built-in agent templates (CloudWatch, more coming)
├── tools/
│   ├── adapters/        Tool adapters — Claude Code, Codex, generic CLI
│   ├── discovery.ts     Auto-detect installed CLI tools
│   └── registry.ts      Tool registry and capability mapping
└── types/               TypeScript type definitions
```

### Agent Definitions

Agents are defined with goals, schedules, and tool assignments. Create them from the V16 dashboard; this runtime executes them locally and reports results back.

> - Run on a **cron schedule** (e.g., every 30 minutes) — scheduling happens on your machine, not the cloud
> - Use any **installed CLI tool** as its executor
> - Access the **local filesystem** and working directory
> - Stream output back to the dashboard in real-time
> - **Report completions** to the backend (triggers Telegram notifications)
> - Be **paused, resumed, or triggered** from the dashboard

### Tool Adapters

Built-in adapters for popular AI coding tools, plus a generic adapter for anything with a CLI:

| Adapter | Tool | Description |
|:--------|:-----|:------------|
| `claude-code` | [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | Anthropic's CLI coding agent |
| `codex` | [Codex CLI](https://github.com/openai/codex) | OpenAI's CLI coding agent |
| `generic` | Any CLI | Wrap any command-line tool as a V16 agent |

### Auto-Discovery

The agent automatically detects installed CLI tools on your machine and registers them as available executors. No configuration needed.

## Install

```bash
npm install -g v16.ai
```

## Quick Start

```bash
# 1. Login with your V16 token (from v16.ai/dashboard)
v16 login --token <your-token>

# 2. Start the agent
v16 connect

# Agent runs on http://localhost:7160
# Create and manage agents from the dashboard.
```

## Commands

| Command | Description |
|:--------|:------------|
| `v16 connect` | Start the local agent HTTP server + scheduler (port 7160) |
| `v16 connect --port <port>` | Start on a custom port |
| `v16 status` | Show connection status and installed tools |
| `v16 tools` | List detected CLI tools |
| `v16 run <tool> <prompt>` | Run a CLI tool locally |
| `v16 agents list` | List registered agents |
| `v16 agents create` | Create a new agent |
| `v16 agents remove` | Remove an agent |
| `v16 login --token` | Set your auth token |

## Architecture

```
  ┌───────────────────────────┐
  │                           │
  │   V16 Dashboard           │
  │   v16.ai                  │
  │                           │
  │   Agent CRUD · Scheduling │
  │   History · Alerts        │
  │                           │
  └─────────────┬─────────────┘
                │
          HTTP (localhost)
                │
  ┌─────────────┴─────────────────────────────────────────────┐
  │                                                           │
  │   Your Machine — localhost:7160                           │
  │                                                           │
  │   ┌─────────────┐    ┌─────────────┐    ┌─────────────┐  │
  │   │  Express     │───▶│  Scheduler  │───▶│  Tool       │  │
  │   │  HTTP Server │    │  (Cron)     │    │  Discovery  │  │
  │   └─────────────┘    └─────────────┘    └──────┬──────┘  │
  │                                                │          │
  │   ┌────────────────────────────────────────────┴───────┐  │
  │   │   Tool Adapters                                    │  │
  │   │                                                    │  │
  │   │   ┌─────────────┐ ┌─────────────┐ ┌────────────┐  │  │
  │   │   │ Claude Code │ │    Codex    │ │ Generic CLI│  │  │
  │   │   └─────────────┘ └─────────────┘ └────────────┘  │  │
  │   └────────────────────────────────────────────────────┘  │
  │                                                           │
  │   API keys, code, and data never leave this machine.      │
  │                                                           │
  └───────────────────────────────────────────────────────────┘
```

## Design Principles

## Configuration

Config stored at `~/.v16/config.json`:

```json
{
  "serverUrl": "https://api.v16.ai",
  "token": "your-auth-token",
  "agents": []
}
```

## Requirements

- **Node.js 18+**
- At least one CLI tool installed (Claude Code, Codex, or any custom CLI)

## Contributing

PRs welcome. If you build a new tool adapter, we'd love to include it.

## Links

- **Platform** — [v16.ai](https://v16.ai)
- **Dashboard** — [v16.ai/dashboard](https://v16.ai/dashboard)
- **Issues** — [github.com/anup-singhai/v16-agents/issues](https://github.com/anup-singhai/v16-agents/issues)

## License

MIT

---

Built by <a href="https://v16.ai">V16</a> — your agents, your machine, your keys.

v16-agents

v16-agents Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

v16-agents

v16-agents Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README