Skip to main content

​
Prerequisites

  • Java 21+ — check with java -version. Install via SDKMAN: sdk install java 21.0.9-librca
  • An API key for at least one provider:
ProviderEnvironment VariableGet a key
Anthropic (default)ANTHROPIC_API_KEYconsole.anthropic.com
OpenAIOPENAI_API_KEYplatform.openai.com
Google GeminiGOOGLE_API_KEYaistudio.google.com
export ANTHROPIC_API_KEY=sk-ant-...

​
Install

1

Download the JAR

curl -LO https://github.com/markpollack/loopy/releases/download/v0.2.0/loopy-0.2.0-SNAPSHOT.jar
2

Run it

java -jar loopy-0.2.0-SNAPSHOT.jar
The TUI launches with a chat interface. Type a message and press Enter.
Or build from source: 
git clone https://github.com/markpollack/loopy.git
cd loopy
./mvnw package
java -jar target/loopy-0.2.0-SNAPSHOT.jar

​
Your First Session

Loopy starts in interactive TUI mode by default — a terminal chat interface with real-time agent feedback and a spinner while the agent thinks. Try giving it a coding task: 
> Add input validation to the User class — name must be non-blank, email must match RFC 5322
The agent reads your codebase (via CLAUDE.md if present), plans the change, edits files, and verifies the result. You see token usage and estimated cost after each response: 
tokens: 1234/567 | cost: $0.0089

​
Three Execution Modes

ModeCommandUse case
TUI (default)loopyInteractive development — chat, iterate, explore
Printloopy -p "your task"Scripting and CI — single task, stdout output
REPLloopy --replQuick tasks — readline loop, no TUI overhead

​
Slash Commands

Lines starting with / are intercepted before reaching the agent — no LLM tokens consumed.
CommandWhat it does
/helpList all commands
/skillsDiscover, search, install domain skills
/boot-newScaffold a new Spring Boot project
/startersDiscover Agent Starters for your project
/boot-addAdd capabilities to an existing project
/boot-modifyStructural changes (Java version, CI, native image)
/btw <question>Side question without polluting session context
/session saveSave current session for later
/clearReset conversation memory

​
Add Project Context

Create a CLAUDE.md file in your project root. Loopy reads it automatically and appends it to the agent’s system prompt — same convention as Claude Code. 
# My Project

- Spring Boot 3.4 with Java 21
- Use constructor injection, never field injection
- Tests use @WebMvcTest with MockMvc
- API returns ProblemDetail for errors (RFC 9457)
No CLI flags needed. The agent sees your conventions on every turn.

​
What’s Next

Extending Loopy

Custom skills, subagents, tool profiles, and the programmatic API

CLI Reference

All flags, options, and configuration