codexyy - AI coding agent for your terminal

open beta - free with your api key

codexyy is a Node.js CLI that thinks, reads, edits, and runs code - powered by Claude. Pure terminal. No browser required.

curl codexyy.dev/install | sh

Start for free See the features →

bash - ~/my-project

$ codexyy
  codexyy v0.1.0  |  claude-sonnet-4-6
  Type /help for commands
 
You > fix the off-by-one in src/parser.ts
 
  - read_file("src/parser.ts")  83 lines
  - write_file("src/parser.ts")  written
 
Fixed: loop was using <= instead of < on line 47.
The array is 0-based, so last valid index is length-1.
Tests should pass now.

Getting started

Up and running in 60 seconds

Install the CLI

One command. Drops a Node.js script into your PATH. No containers, no config.

curl codexyy.dev/install | sh

Set your API key

Your Anthropic key, saved to ~/.config/codexyy. Or use Pro and skip this step.

export ANTHROPIC_API_KEY=sk-ant-...

Start coding

Run codexyy in any project. The agent reads your code, edits files, runs commands.

cd my-project && codexyy

Capabilities

Six tools. One agent.

The agent picks the right tools automatically - you just describe what you want.

Chat with AI

Talk to Claude in plain English. Fix bugs, add features, explain code, or refactor - it understands your whole project.

Streams token by token
Full project context
/help, /clear, /model, /cost

Read & Edit Files

Reads files before touching them, then makes targeted edits. Every write shows a unified diff so you see exactly what changed.

Always reads before editing
Unified diff on every write
Creates directories automatically

Run Commands

Shell commands run with full stdout/stderr capture. The agent sees the output and can iterate - fix a failing test on the spot.

Full stdout and stderr
Configurable timeout
Agent reacts to output

Smart Search

Grep files by pattern, find by name, or walk the directory tree. The agent orients itself before making any changes.

Regex and literal grep
File name pattern matching
Tree view with depth control

--online

Want a UI? Add one flag.

Run codexyy --online and a local web companion opens in your browser - terminal output, file viewer, editor, and optional AI chat. Still your machine. Still your code.

Live terminal output panel
File tree browser and editor
AI chat panel (optional)
Served locally - nothing leaves your machine

localhost:7842

export function parse(src: string) {

const tokens = []

for (let i = 0; i < src.length; i++) {

if (i < src.length - 1) {

tokens.push(src[i])

}

return tokens

}

Pricing

Free forever, or $5 for zero config.

BYOK is free forever. Pro removes the API key requirement for $5/mo.

Free

forever

Bring your own Anthropic API key. All features, all tools, unlimited sessions.

✓ Full AI coding agent
✓ All 6 tools (read, write, bash, search...)
✓ Your own Anthropic API key
✓ Unlimited sessions and messages
✓ --online browser companion

Install now