Capri-AI README

The project's README from github.com/ShineStormEnhance/Capri-AI. As one markdown file: README.md.

Capri AI

🌃 Capri — a cyberpunk AI agent for your desktop. One app for Claude Code, Codex, Antigravity & any AI assistant.

Features · Quick Start · What You Can Ask · How It Works · Roadmap · FAQ

🌃 What is Capri?

Capri is a cyberpunk AI agent that lives on your Windows desktop. Think of it as your own JARVIS-style assistant: you describe what you want in plain language, and Capri plans the steps, uses the right tools and gets it done on your machine.

Under the hood, Capri is a desktop interface and agent layer on top of the AI assistants you already use. It works with Claude Code, Codex, Antigravity and other AI assistants, so you pick the brain and Capri provides the body.

Capri is a Cyberpunk-inspired project. Its name and neon style nod to the AI construct from Cyberpunk: Edgerunners 2, and it is made for anyone who wants an edgerunner-grade AI sidekick on their PC.

Why Capri?

	Terminal-only AI assistants	Capri
Interface	Command line	Native desktop app
Setup	Install runtimes, edit configs by hand	Download, sign in, go
Choice of AI	One assistant per tool	Switch between Claude Code, Codex, Antigravity and more
Scope	Usually focused on coding in a project folder	Your whole desktop: files, projects, apps and tasks
Who it's for	Developers	Everyone, developers included

🔴 Inspired by Cyberpunk: Edgerunners

Capri is built for people who like their tech with an edge. The project takes its look and spirit from the cyberpunk genre and from Cyberpunk: Edgerunners, where a mysterious AI construct named Capri appears in season 2.

🌃 Cyberpunk aesthetic: neon red and cyan on near-black, sharp edges and glitchy details.
🧑‍💻 Netrunner energy: you give the order, your AI operator handles the rest.
🔴 Edgerunner attitude: fast, independent and on your side.

⚡ Features

	Feature	What it means for you
🧠	Bring any brain	Plug in Claude Code, Codex, Antigravity or another assistant and switch between them at any time.
🖥️	Desktop-native	A real app with a clean interface. No terminal required.
📂	Files and projects	Ask Capri to find, read, organize and edit files and whole project folders.
⚙️	Full agent toolkit	Capri plans a task, uses tools, checks the result and reports back.
💻	Code on demand	Write, refactor, debug and run code through the engine you prefer.
🔁	Automations	Turn repeated chores into a single sentence.
🛡️	You stay in control	Review what Capri is about to do and approve or deny it.
🎨	Cyberpunk interface	A dark neon, Edgerunners-inspired theme that makes your desktop feel like a netrunner's deck.

🚀 Quick Start

1. Download

Capri is currently available for Windows in two formats:

Format	Download	Best for
🎒 Portable	`Capri-Portable.zip`	Running Capri from any folder, no installation needed

Requires Windows 10 or newer. macOS and Linux versions are on the roadmap.

2. Install and launch

Installer: run Capri-Setup.exe, follow the wizard, then open Capri from the Start menu.
Portable: put the portable build in any folder and run it. No installation needed.

Windows shows a SmartScreen warning?

New apps that are not yet widely downloaded can trigger a SmartScreen prompt. If you downloaded Capri from this repository's Releases page, click More info → Run anyway.

3. Connect your AI

On first launch, Capri asks which assistant to use. Sign in to your account or paste your API key for Claude Code, Codex, Antigravity or another supported assistant.

💬 What You Can Ask

You say	Capri does
"Clean up my Downloads folder and group everything by type."	Scans the folder, proposes a plan and moves files after your approval.
"Find the bug in this project and fix it."	Reads the code, locates the issue, patches it and runs the checks.
"Summarize every PDF in this folder into one document."	Reads each file and writes a single combined summary.
"Set up a new web app and start it."	Scaffolds the project, installs dependencies and launches it.
"Every Monday, back up my Documents folder."	Creates a recurring automation for the task.

🧬 How It Works

flowchart LR
    U([You]) -->|plain language| C[Capri Desktop]
    C --> R{Engine Router}
    R --> E1[Claude Code]
    R --> E2[Codex]
    R --> E3[Antigravity]
    R --> E4[Any other assistant]
    C --> T[Tool Layer]
    T --> F[Files and projects]
    T --> S[Shell and apps]
    T --> W[Web]
    C --> G[Approval Gate]
    G -->|you confirm| T

    classDef neon fill:#0a0a12,stroke:#ff003c,color:#00f0ff,stroke-width:2px;
    class C,R,T,G neon;

You describe the goal in plain language.
Capri routes it to the AI engine you selected.
The engine plans the steps and asks Capri to use tools.
You approve sensitive actions, and Capri carries them out on your desktop.

Supported engines

Engine	Status
Claude Code	✅ Supported
Codex	✅ Supported
Antigravity	✅ Supported
Other assistants	🧩 Via custom adapter

⚙️ Configuration

# Example config
engine: claude-code        # claude-code | codex | antigravity | custom

permissions:
  mode: ask                # ask before acting | auto | read-only
  allowed_folders:
    - ~/Documents
    - ~/Projects

interface:
  theme: cyberpunk

🛡️ Safety

An agent that works on your desktop is powerful, so treat it with care:

Review before you approve. Read what Capri is about to do, especially for deleting, moving or overwriting files.
Limit the scope. Give Capri access only to the folders it needs.
Keep backups. Back up important data before running large automated tasks.
Protect your keys. Never share your API keys or account tokens with anyone.

🗺️ Roadmap

Windows app (installer and portable)
Multiple AI engines
Voice control
macOS version
Linux version
Plugin system
Task scheduler
Mobile companion
Community cyberpunk theme gallery

Have an idea? Open an issue and tell us what Capri should learn next.

❓ FAQ

Does Capri work on macOS or Linux?

Not yet. Capri is currently available for Windows as an installer (.exe) and a portable build. macOS and Linux versions are planned, so star the repo to follow the progress.

Do I need to know how to code?

No. Download the app, connect your AI and describe what you need in plain language.

Which AI assistants does Capri support?

Claude Code, Codex and Antigravity out of the box, plus other assistants through custom adapters.

Is it safe to let an AI control my desktop?

Capri is designed so you can review actions before they run, but no tool is risk-free. Limit folder access, keep backups and read the Safety section.

Where does my data go?

Your requests are processed by the AI assistant you connect, under that provider's terms and privacy policy.

Is Capri an official Cyberpunk or Edgerunners product?

No. Capri is an independent, unofficial fan project with a cyberpunk aesthetic, inspired by Cyberpunk: Edgerunners. It is not affiliated with or endorsed by CD PROJEKT RED, Studio Trigger, Netflix or any other rights holder.

If Capri saves you time, drop a ⭐ and share it with a friend.

Stay sharp, edgerunner.

Searching Database…

328 ·GitHub

Capri-AI