Metadata-Version: 2.5
Name: velune-cli
Version: 0.9.9
Summary: Local-first, multi-model AI developer CLI with council-based agents, persistent memory, and repository cognition
Project-URL: Homepage, https://github.com/Surya-Hariharan/Velune-CLI
Project-URL: Repository, https://github.com/Surya-Hariharan/Velune-CLI
Project-URL: Documentation, https://github.com/Surya-Hariharan/Velune-CLI#readme
Project-URL: Issues, https://github.com/Surya-Hariharan/Velune-CLI/issues
Project-URL: Changelog, https://github.com/Surya-Hariharan/Velune-CLI/blob/main/CHANGELOG.md
Project-URL: Security, https://github.com/Surya-Hariharan/Velune-CLI/blob/main/SECURITY.md
Author-email: Surya HA <suryahariharan2006@gmail.com>
Maintainer-email: Surya HA <suryahariharan2006@gmail.com>
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Keywords: ai,cli,coding-assistant,llm,local-ai,mcp,multi-agent,ollama,terminal
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development
Classifier: Topic :: Terminals
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: aiosqlite>=0.19.0
Requires-Dist: cryptography>=43.0.1
Requires-Dist: httpx<1,>=0.27.0
Requires-Dist: keyring>=24.0.0
Requires-Dist: mcp<2.0.0,>=1.30.0
Requires-Dist: networkx>=3.2.0
Requires-Dist: numpy<3,>=1.26.0; python_version < '3.13'
Requires-Dist: numpy<3,>=2.1.0; python_version == '3.13'
Requires-Dist: numpy<3,>=2.3.2; python_version >= '3.14'
Requires-Dist: packaging>=23.0
Requires-Dist: pathspec>=0.12.0
Requires-Dist: platformdirs>=4.2.0
Requires-Dist: prompt-toolkit<4,>=3.0.48
Requires-Dist: psutil>=6.0.0
Requires-Dist: pydantic-settings>=2.14.2
Requires-Dist: pydantic<3,>=2.11.0; python_version < '3.14'
Requires-Dist: pydantic<3,>=2.12.0; python_version >= '3.14'
Requires-Dist: rank-bm25>=0.2.2
Requires-Dist: rich>=13.9.0
Requires-Dist: structlog>=24.1.0
Requires-Dist: tiktoken>=0.12.0; python_version >= '3.14'
Requires-Dist: tiktoken>=0.8.0; python_version < '3.14'
Requires-Dist: toml>=0.10.2
Requires-Dist: tomli>=2.0.1; python_version < '3.11'
Requires-Dist: typer>=0.16.0
Provides-Extra: all
Requires-Dist: docker>=7.0.0; extra == 'all'
Requires-Dist: gguf>=0.6.0; extra == 'all'
Requires-Dist: lancedb>=0.14.0; (python_version < '3.13') and extra == 'all'
Requires-Dist: lancedb>=0.16.0; (python_version >= '3.13') and extra == 'all'
Requires-Dist: opentelemetry-api>=1.45.1; extra == 'all'
Requires-Dist: opentelemetry-exporter-otlp>=1.22.0; extra == 'all'
Requires-Dist: opentelemetry-sdk>=1.22.0; extra == 'all'
Requires-Dist: pyarrow>=14.0.0; (python_version < '3.13') and extra == 'all'
Requires-Dist: pyarrow>=18.0.0; (python_version == '3.13') and extra == 'all'
Requires-Dist: pyarrow>=22.0.0; (python_version >= '3.14') and extra == 'all'
Requires-Dist: pyyaml>=6.0.1; extra == 'all'
Requires-Dist: qdrant-client>=1.10.0; extra == 'all'
Requires-Dist: tree-sitter-go>=0.23.0; extra == 'all'
Requires-Dist: tree-sitter-python>=0.23.0; extra == 'all'
Requires-Dist: tree-sitter-rust>=0.23.0; extra == 'all'
Requires-Dist: tree-sitter-typescript>=0.23.0; extra == 'all'
Requires-Dist: tree-sitter<1,>=0.23.0; (python_version < '3.13') and extra == 'all'
Requires-Dist: tree-sitter<1,>=0.23.1; (python_version == '3.13') and extra == 'all'
Requires-Dist: tree-sitter<1,>=0.25.1; (python_version >= '3.14') and extra == 'all'
Provides-Extra: api
Requires-Dist: pyyaml>=6.0.1; extra == 'api'
Provides-Extra: dev
Requires-Dist: bandit[toml]>=1.7.0; extra == 'dev'
Requires-Dist: build>=1.0.0; extra == 'dev'
Requires-Dist: pip-audit>=2.6.0; extra == 'dev'
Requires-Dist: pre-commit>=3.6.0; extra == 'dev'
Requires-Dist: ptyprocess>=0.7.0; (sys_platform != 'win32') and extra == 'dev'
Requires-Dist: pyright>=1.1.350; extra == 'dev'
Requires-Dist: pyte>=0.8.2; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: pywinpty>=3.0.0; (sys_platform == 'win32') and extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Requires-Dist: twine>=7.0.0; extra == 'dev'
Provides-Extra: docker
Requires-Dist: docker>=7.0.0; extra == 'docker'
Requires-Dist: pyyaml>=6.0.1; extra == 'docker'
Provides-Extra: gguf
Requires-Dist: gguf>=0.6.0; extra == 'gguf'
Provides-Extra: git
Provides-Extra: mysql
Requires-Dist: pymysql>=1.1; extra == 'mysql'
Provides-Extra: parsing
Requires-Dist: tree-sitter-go>=0.23.0; extra == 'parsing'
Requires-Dist: tree-sitter-python>=0.23.0; extra == 'parsing'
Requires-Dist: tree-sitter-rust>=0.23.0; extra == 'parsing'
Requires-Dist: tree-sitter-typescript>=0.23.0; extra == 'parsing'
Requires-Dist: tree-sitter<1,>=0.23.0; (python_version < '3.13') and extra == 'parsing'
Requires-Dist: tree-sitter<1,>=0.23.1; (python_version == '3.13') and extra == 'parsing'
Requires-Dist: tree-sitter<1,>=0.25.1; (python_version >= '3.14') and extra == 'parsing'
Provides-Extra: postgres
Requires-Dist: psycopg[binary]>=3.1; extra == 'postgres'
Provides-Extra: rag
Requires-Dist: lancedb>=0.14.0; (python_version < '3.13') and extra == 'rag'
Requires-Dist: lancedb>=0.16.0; (python_version >= '3.13') and extra == 'rag'
Requires-Dist: pyarrow>=14.0.0; (python_version < '3.13') and extra == 'rag'
Requires-Dist: pyarrow>=18.0.0; (python_version == '3.13') and extra == 'rag'
Requires-Dist: pyarrow>=22.0.0; (python_version >= '3.14') and extra == 'rag'
Requires-Dist: qdrant-client>=1.10.0; extra == 'rag'
Provides-Extra: telemetry
Requires-Dist: opentelemetry-api>=1.45.1; extra == 'telemetry'
Requires-Dist: opentelemetry-exporter-otlp>=1.22.0; extra == 'telemetry'
Requires-Dist: opentelemetry-sdk>=1.22.0; extra == 'telemetry'
Description-Content-Type: text/markdown

<div align="center">

<img src="https://raw.githubusercontent.com/Surya-Hariharan/Velune-CLI/main/docs/assets/velune-hero.svg" alt="Velune CLI: a faceted three-dimensional V symbol with five agent nodes (Planner, Coder, Reviewer, Challenger, Synthesizer) converging on it" width="100%">

<h1>Velune CLI</h1>

<h3>Your models. Your machine. Your approval.</h3>

<p>An open-source, local-first AI engineer for your terminal.</p>

<p><a href="https://velune-cli.vercel.app/"><strong>Visit the website →</strong></a></p>

<p>
<a href="https://pypi.org/project/velune-cli/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/velune-cli"></a>
<a href="https://pypi.org/project/velune-cli/"><img alt="Python versions" src="https://img.shields.io/pypi/pyversions/velune-cli"></a>
<a href="https://github.com/Surya-Hariharan/Velune-CLI/actions/workflows/ci.yml"><img alt="CI status" src="https://img.shields.io/github/actions/workflow/status/Surya-Hariharan/Velune-CLI/ci.yml?branch=main&label=CI"></a>
<a href="https://github.com/Surya-Hariharan/Velune-CLI/blob/main/LICENSE"><img alt="License: Apache-2.0" src="https://img.shields.io/badge/license-Apache--2.0-blue"></a>
<a href="https://github.com/Surya-Hariharan/Velune-CLI"><img alt="GitHub stars" src="https://img.shields.io/github/stars/Surya-Hariharan/Velune-CLI?style=flat"></a>
</p>

<p>
<img alt="Status: beta" src="https://img.shields.io/badge/status-beta-orange">
<img alt="Local-first" src="https://img.shields.io/badge/local--first-yes-brightgreen">
<img alt="No analytics" src="https://img.shields.io/badge/analytics-none-brightgreen">
<img alt="MCP client and server" src="https://img.shields.io/badge/MCP-client%20%2B%20server-blueviolet">
<img alt="Tested on Windows, macOS and Linux" src="https://img.shields.io/badge/CI-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey">
</p>

</div>

---

## Here's the deal.

AI can write code. Fine. The real question is whether you let it near the codebase that pays your bills.

You've got five worries, and they're all fair:

<div align="center">
<img src="https://raw.githubusercontent.com/Surya-Hariharan/Velune-CLI/main/docs/assets/velune-questions.svg" alt="Five questions teams ask before letting AI touch a codebase, with Velune's answer to each: where your code goes, who checks the answer, what it may change, which models you can use, and whether it knows your project" width="100%">
</div>

Velune answers every one of them. And every answer points at a file in this repo. Don't take my word for it. Go check.

## What you get

- 🔒 **Your code stays yours.** Run a model on your own machine. No analytics, no usage data sent to us
  ([proof](https://github.com/Surya-Hariharan/Velune-CLI/blob/main/SECURITY.md#zero-telemetry)).
- 🧠 **A council, not a lone gun.** Easy question? One seat. Big refactor? Up to nine seats, including a Challenger
  whose whole job is to poke holes in the plan.
- 🛡️ **You hold the leash.** Manual by default. Every change is a diff you approve. One command to undo.
- 📚 **It remembers.** Five memory tiers per project, so it knows your code before you explain it.

<div align="center">
<img src="https://raw.githubusercontent.com/Surya-Hariharan/Velune-CLI/main/docs/assets/velune-council.svg" alt="A matrix of council seats by depth tier. Instant uses the Coder only, minimal adds the Planner, standard adds the Reviewer and Synthesizer, and full uses all nine seats: five core roles and four specialist critics" width="100%">
</div>

<div align="center">
<img src="https://raw.githubusercontent.com/Surya-Hariharan/Velune-CLI/main/docs/assets/velune-permissions.svg" alt="A matrix of the Manual, Plan and Auto execution modes against reads, ordinary changes, high-risk changes and changes outside the workspace, showing what is allowed, asked or refused. Manual is the default" width="100%">
</div>

It works like this:

```text
/plan add input validation to signup     it investigates and writes a plan. No file touched.
approve                                  it runs the plan. You see every diff first.
/diff                                    see exactly what changed
/rewind                                  don't like it? Undo the agent's last turn.
```

A council raises your odds of a good answer. It doesn't promise one. It costs more calls than a single model, so it only
shows up when the task needs it. Read your diffs.

## Plugs into everything

<div align="center">
<img src="https://raw.githubusercontent.com/Surya-Hariharan/Velune-CLI/main/docs/assets/velune-connect.svg" alt="Velune CLI at the centre, connecting to 18 model providers (4 local and 14 cloud), to opt-in application integrations (Docker, HTTP APIs, PostgreSQL, MySQL and MariaDB, Supabase, background processes), to MCP as both server and client, and to plugins, hooks and custom slash commands" width="100%">
</div>

## The numbers

No hype. Counted from the code. A test recomputes them on every CI run and fails if they drift.

<div align="center">
<img src="https://raw.githubusercontent.com/Surya-Hariharan/Velune-CLI/main/docs/assets/velune-numbers.svg" alt="Counted from the repository: 18 provider adapters, 56 slash commands in 12 categories, 5 memory tiers, 9 council seats at full depth, 3 operating systems by 5 Python versions in CI, and 0 analytics services" width="100%">
</div>

The honest part: this is **beta**. Things change between releases. Command execution is process management, not an
OS-level sandbox (a Docker sandbox is opt-in). The full list of limits is in
[SECURITY.md](https://github.com/Surya-Hariharan/Velune-CLI/blob/main/SECURITY.md).

## Get in. Two minutes.

**macOS, Linux, WSL**

```bash
curl -fsSL https://raw.githubusercontent.com/Surya-Hariharan/Velune-CLI/main/scripts/install.sh | sh
```

**Windows (PowerShell)**

```powershell
irm https://raw.githubusercontent.com/Surya-Hariharan/Velune-CLI/main/scripts/install.ps1 | iex
```

Or `pipx install velune-cli` / `uv tool install velune-cli`. The installer needs no existing Python.

Then pick your lane:

```bash
# Fully local
ollama pull qwen2.5-coder:7b
cd your-project && velune init && velune

# Cloud (Groq free tier)
cd your-project && velune init --provider groq && velune setup && velune
```

Something off? Run `velune doctor`.

## Join in

One maintainer. Open doors.
[Open an issue](https://github.com/Surya-Hariharan/Velune-CLI/issues/new/choose) ·
[Contribute](https://github.com/Surya-Hariharan/Velune-CLI/blob/main/CONTRIBUTING.md) ·
[Report a vulnerability](https://github.com/Surya-Hariharan/Velune-CLI/security/advisories/new) (privately, never in a public issue).

**Go deeper:**
[Reference](https://github.com/Surya-Hariharan/Velune-CLI/blob/main/docs/reference.md) ·
[Usage guide](https://github.com/Surya-Hariharan/Velune-CLI/blob/main/docs/usage-guide.md) ·
[Slash commands](https://github.com/Surya-Hariharan/Velune-CLI/blob/main/docs/slash-commands.md) ·
[Security](https://github.com/Surya-Hariharan/Velune-CLI/blob/main/SECURITY.md) ·
[Changelog](https://github.com/Surya-Hariharan/Velune-CLI/blob/main/CHANGELOG.md)

---

<div align="center">

Licensed under [Apache 2.0](https://github.com/Surya-Hariharan/Velune-CLI/blob/main/LICENSE). Copyright 2026 Surya HA.
Third-party names belong to their owners and identify services Velune can connect to.
See [NOTICE](https://github.com/Surya-Hariharan/Velune-CLI/blob/main/NOTICE),
[AUTHORS](https://github.com/Surya-Hariharan/Velune-CLI/blob/main/AUTHORS.md) and the
[Code of Conduct](https://github.com/Surya-Hariharan/Velune-CLI/blob/main/CODE_OF_CONDUCT.md).

</div>
