persistent REPL + repository cognition

Code stays local.AI understands

$pip install velune-cli
v0.9.0latest stable release
local-firstzero cloud dependencies
open sourceApache 2.0 licensed
Capabilities

Terminal-first
developer AI.

A local-first REPL that understands your repository, remembers across sessions, and routes intelligently to the right model for the task. Built for developers who want AI that stays under their control.

01

Persistent REPL Session

Launch once with `velune` and stay inside. Ask questions directly, use slash commands like `/run`, `/model`, and `/optimus`, or pick from interactive menus. Your session never drops.

session continuity
02

Codebase Understanding

Velune maps how your project connects — functions, modules, and dependencies. Ask high-level questions about your architecture, not just which file contains what.

100%project coverage
03

Memory Across Sessions

Velune remembers past decisions, recurring patterns, and architectural context across days and weeks. The longer you use it, the better it understands your project.

3memory layers
04

Any Model, One CLI

Run locally with Ollama or route to OpenAI, Anthropic, Gemini, Groq, and more. Switch between speed and power with a single command. Credentials stay on your machine.

7+providers
Installation

Install.
Audit.
Analyze.

velune-cli
$ pip install velune-cli
$ velune init --provider ollama
 
# Velune initialized
# ✓ .velune/ directory created
# ✓ Ready to launch
01

Install

in seconds

Install Velune as a Python package. Supports Ollama (local), OpenAI, Anthropic, or any provider. Credentials stored securely in OS keyring.

$pip install velune-cli
02

Launch

the REPL

Start the persistent REPL session. Direct prompts or slash commands. Arrow-key navigation, interactive pickers, live streaming.

$velune
03

Work

interactively

Ask questions, use /run for autonomous tasks (Phase 2+), adjust with /optimus (fast) or /godly (powerful). Your memory persists.

Live demo

See it
work.

Install, init, and run. Five specialised agents review your task from every angle — planning, writing, reviewing, challenging, and synthesising — before anything is shipped.

~/my-project — velune
$
council agent contributions
Planner4 turns
Coder14 turns
Reviewer9 turns
Challenger6 turns
Synth3 turns
128Ktoken context (godly mode)
Integrations

Connect
everything.

Route to OpenAI, Anthropic, Groq, xAI, Gemini, or run locally with Ollama. Understand your codebase via GitHub. Execute in Terminal. All in one CLI.

LLM
OpenAI
LLM
Anthropic
LLM
Groq
LLM
xAI
LLM
Google Gemini
Local
Ollama
Code
GitHub
Code
GitLab
Infra
Docker
Editor
VS Code
Execution
Terminal
Database
Supabase
5+frontier LLM APIs
3+Local model runtimes
4+Dev tools integrated
View on GitHub

Privacy by
default.

Privacy by default

Runs locally by default

Velune works entirely on your machine out of the box. Cloud providers are available when you need them, but never required.

Remembers across sessions

Velune builds up knowledge of your project over time — past decisions, recurring patterns, and architectural context that carries forward.

No lock-in, ever

Start with local models, switch to any cloud provider, and switch back — same CLI, same memory, no configuration rewrites.

0
Context tokens built
per session on average
no cloud required
Local by default
0%
average across repos
Project indexed
<0s
Ollama (local)GroqOpenAIAnthropicGoogle GeminixAIOpenRouter
Design principles

Principled
from the ground up.

Velune is built on four non-negotiables: your code stays on your machine by default, you are never locked into one AI provider, every change is previewed before it happens, and the roadmap is honest about what exists today versus what is coming.

· · ○· · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○· · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○· · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○· · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○· · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○· · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○· · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○· · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○· · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○· · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○· · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○· · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ ○· · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ ○· · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○ ○ · · ○ · · ○ · ·○ · · · ○· · ○ · · ○ · · ○ · · ○
privacy guarantee
100%local by default, cloud optional
Apache 2.0Local-firstSandboxedRollback-safe

Private by default

Runs locally on your machine. Your code never leaves unless you choose to route to a cloud provider. Credentials are stored securely in your OS keyring.

Understands your project

Velune maps your codebase structure — not just text. It knows how things connect, so it can reason about the impact of any change before acting.

Always shows the diff

Before any file is changed, Velune shows exactly what it wants to do. Review line by line, accept or reject. One command to roll back.

No lock-in, ever

Start with Ollama locally, move to OpenAI, switch to Anthropic — same CLI, same memory, same session. Change your mind anytime.

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · ·
Devlog

Building in public — the journey.

CurrentPhase 0: Solid Foundation
Every great tool starts with a foundation you can trust. We took the time to get the async runtime, streaming, and security model exactly right before shipping anything else.
v0.9stable release
Development phases
Roadmap

What's
coming.

Velune is actively developed. Here's where we are, and where we're going.

Phase 1In Development

Reliable MVP

REPL, streaming, model routing

  • Persistent REPL — launch once, stay inside
  • Live streaming responses from Ollama and cloud providers
  • Conversation memory that carries context through your session
  • Automatic model selection based on task type
  • /run for autonomous task execution
  • /model to switch AI providers interactively
  • Speed modes: /optimus (fast) and /godly (max power)
  • Session history stored locally on your machine
Follow development
Phase 2aPlanned

Repository Cognition

Codebase mapping, persistent memory, smart routing

  • Full codebase mapping — functions, classes, and module relationships
  • Memory that recalls past sessions and architectural decisions
  • Semantic memory that understands context, not just keywords
  • Impact analysis before any code change
  • Prompts automatically optimised per AI model
  • Smart routing that learns which model suits each task best
  • Memory ranked by relevance and recency
Suggest features
Phase 2b+Planned

Agents & Orchestration

Multi-agent council, advanced codebase intelligence

  • Deep impact analysis using commit history and dependency signals
  • Scalable codebase graph built for large repositories
  • Symbol tracking that stays accurate across refactors
  • Memory that stays current and avoids surfacing stale context
  • Safe, sandboxed execution — filesystem, git, and terminal
  • Council mode: 5 agents deliberate on every complex task
  • Intelligent module grouping for large, multi-team codebases
  • Context pulled from your actual test run and CI history
Suggest features
Apache 2.0 open sourceCommunity drivenPRs welcome
Read the contributing guide