jarv
An AI agent that behaves like a shell tool. Pipe into it, script it, and point it at a supported provider — cloud or local. Jarv runs commands, edits files, searches the web, and delegates work to parallel subagents.
Documentation · CLI reference · Releases
git diff | jarv review this patch
jarv what process is using port 8080?
jarv --no-tools "Explain this error"
jarv
Why Jarv?
- Scriptable: use one-shot prompts, piped input, and JSON output in scripts and pipelines.
- Multi-provider: choose OpenAI, Anthropic, Gemini, OpenRouter, Groq, DeepSeek, Together, or Fireworks, or run local models with Ollama, LM Studio, or vLLM.
- Lightweight: install a standalone binary with its Python runtime bundled, or a Python package with four direct runtime dependencies. No Node runtime.
- Persistent sessions: keep context per terminal, browse conversation history, and fork earlier prompts. Undo and redo change conversation history; they do not reverse tool actions.
Install
Choose one installation method.
Windows PowerShell:
irm https://github.com/JamesWHomer/jarv/releases/latest/download/install.ps1 | iex
macOS or Linux:
curl -fsSL https://github.com/JamesWHomer/jarv/releases/latest/download/install.sh | sh
Python 3.10+ with uv:
uv tool install jarv
pipx install jarv and pip install jarv are also supported. See the installation guide for API keys, updates, and uninstalling.
First run
jarv /setup
jarv --no-tools "Say hello"
jarv
The setup wizard selects a provider, API key when needed, and model. The one-shot example checks the connection without enabling tools; jarv by itself opens an interactive session. Local providers need a running model server and do not require an API key.
Documentation
The Markdown guides in docs/ are the main source of detailed documentation:
- Getting started — installation, provider setup, and first use.
- Usage — one-shot prompts, pipelines, and interactive mode.
- Tools and safety — command approval, file access, and subagents.
- Sessions — conversation history, branches, and undo/redo.
- Reference — CLI flags, slash commands, and configuration.
Development
See the development guide for running tests and the documentation guide for local previews and Read the Docs setup.
License
1 maintainer
Metadata
1 maintainer
Release files for jarv 0.66.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| jarv-0.66.2.tar.gz | 747.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| jarv-0.66.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.2 MB
Release files / jarv-0.66.2.tar.gz
| Download URL | jarv-0.66.2.tar.gz |
|---|---|
| Size | 747.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
96c66b3fe54bebe40ac0a0aaf855c2502a7b7560aa7844ecc5157dfca4ad0036
|
|
BLAKE2b-256 checksum How to use checksums |
06b4dd388684001ed310ceeba2bd320a15970431edee86c92e3e6ab42bbcdb0f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.
Transparency logRelease files / jarv-0.66.2-py3-none-any.whl
| Download URL | jarv-0.66.2-py3-none-any.whl |
|---|---|
| Size | 480.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5369248d52ab708e2c0da6aa55dfccac2888ad73fa2f9f890dab8925afba2d32
|
|
BLAKE2b-256 checksum How to use checksums |
4350b2301307f390a9090812e7c5f8aef2d2fd3080f848edc3a04289410c86ed
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.
Transparency log
