Agent JAE

Your AI-powered terminal coding agent.
Build, debug, and ship code — directly from the command line.

---

What is Agent JAE?

Agent JAE is an interactive AI coding assistant that lives in your terminal. It understands your codebase, executes commands, edits files, runs tests, and helps you build software faster — all through natural conversation.

Think of it as a senior developer pair-programming with you, but it never sleeps and never judges your variable names.

Key Features

🐉 Terminal-Native — Full TUI (Terminal UI) with syntax highlighting, diff views, and interactive panels. No browser required.

🤖 Multi-Provider AI — Works with 24+ LLM providers and 811+ models including OpenAI, Anthropic, Google, Venice AI, DeepSeek, Mistral, Groq, and more.

🛠️ Built-in Tools — Read, write, and edit files. Run bash commands. Search codebases. Execute tests. All integrated.

🧩 Extensible Skills System — Install community skills from the marketplace or create your own. Hot-loadable, no restart required.

🔌 16 Default Extensions — Replay sessions, PR review, project DNA analysis, cost tracking, swarm mode, checkpoints, teach mode, and more — all built in.

🎨 Venice AI Integration — 11 pre-installed Venice skills for image generation, video creation, text-to-speech, model benchmarking, and chat.

📡 Multiple Interfaces — TUI mode for interactive sessions, CLI mode for scripting and CI/CD, RPC mode for programmatic access, and a Web UI.

💾 Session Memory — Conversations persist across sessions. Pick up right where you left off.

🔒 Sandboxed Execution — Code runs safely with configurable permissions and Docker isolation support.

---

Quick Start

Prerequisites

• Node.js v18+ (includes npm) — nodejs.org
• An API key from a supported provider (Venice AI, OpenAI, Anthropic, etc.)

Linux users: Before installing, fix npm global permissions to avoid EACCES errors:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

This only needs to be done once. Alternatively you can use sudo npm install -g ... but the prefix fix is cleaner.

Install

npm install -g @jaeswift/jae-coding-agent

Run

# Interactive TUI mode
jae

# CLI mode (pipe-friendly)
jae -p "explain this codebase"

# With a specific provider
jae --provider venice --model kimi-k2-5

Configure

On first run, Agent JAE will prompt for your API key. Or set it manually:

# Venice AI (recommended)
export JAE_API_KEY=your-venice-api-key
export JAE_PROVIDER=venice

# Or any supported provider
export OPENAI_API_KEY=your-key
export ANTHROPIC_API_KEY=your-key

Configuration is stored in ~/.jae/ and can be customized per-project.

---

Architecture

Agent JAE is built as a modular monorepo with the following packages:

Package	Description
@jaeswift/jae-coding-agent	The main interactive coding agent CLI
@jaeswift/jae-ai	Unified multi-provider LLM API
@jaeswift/jae-agent-core	Agent runtime with tool calling and state management
@jaeswift/jae-tui	Terminal UI library with differential rendering
@jaeswift/jae-web-ui	Web components for AI chat interfaces
@jaeswift/jae-mom	Slack bot integration
@jaeswift/jae-pods	CLI for managing vLLM deployments on GPU pods

---

Tools

Agent JAE comes with powerful built-in tools:

Tool	What it does
read_file	Read any file in your project
write_file	Create or overwrite files
edit_file	Surgical find-and-replace edits
bash	Execute any shell command
search_files	Regex search across your codebase
test_runner	Run and analyze test suites
install_skill	Add new skills from the marketplace
list_skills	View available and installed skills

---

Extensions

Agent JAE ships with 16 built-in extensions that supercharge your workflow:

Extension	Description
🔄 Replay	Record and replay coding sessions as shareable HTML
👀 PR Review	Automated pull request analysis with security checks
🧬 Project DNA	Generate a codebase fingerprint and architecture map
💰 Cost Tracker	Real-time token usage and cost monitoring
🐉 Swarm Mode	Multi-agent parallel task execution
📸 Checkpoints	Git-based snapshots with one-command rollback
📚 Teach Mode	Save reusable patterns and coding conventions
🛒 Skill Marketplace	Browse, install, and publish community skills
⏰ Pomodoro	Built-in focus timer for deep work sessions
📊 Benchmark	Performance profiling for your code
📝 Changelog	Auto-generate changelogs from git history
🔗 Git Hooks	Automated pre-commit quality checks
📖 Docs Generator	Generate documentation from code
🔐 Secrets Scanner	Detect leaked credentials in your codebase
🏗️ Scaffolder	Project templates and boilerplate generator
🎨 Theme Engine	Customize the TUI appearance

---

Venice AI Skills

11 pre-installed skills powered by Venice AI:

• 🖼️ Image Generation — Generate images from text prompts
• 🎬 Video Generation — Create AI videos from descriptions
• 🗣️ Text-to-Speech — Convert text to natural-sounding audio
• 💬 Chat — Direct conversational AI
• 📋 List Text Models — Browse available text models
• 🖼️ List Image Models — Browse available image models
• 🎬 List Video Models — Browse available video models
• 🔊 List Voice Models — Browse available voice models
• 📊 Benchmark — Compare model performance
• 🎬 Video Quote — Generate stylized video quotes
• 🖼️ Upscale Image — Enhance image resolution

---

Supported Providers

Agent JAE works with virtually any LLM provider:

Provider	Models
Venice AI	kimi-k2-5, llama-3.3-70b, deepseek-r1-671b, and more
OpenAI	GPT-4o, GPT-4.1, o3, o4-mini
Anthropic	Claude 4 Sonnet, Claude 4 Opus
Google	Gemini 2.5 Pro, Gemini 2.5 Flash
DeepSeek	DeepSeek-V3, DeepSeek-R1
Mistral	Mistral Large, Codestral
Groq	Ultra-fast inference
AWS Bedrock	Enterprise-grade access
Azure OpenAI	Enterprise deployments
Ollama	Local models, fully offline
...and 14+ more	See full provider list

---

Development

git clone https://git.jaeswift.xyz/jae/Agent-JAE.git
cd Agent-JAE
npm install
npm run build
./jae-test.sh    # Run from sources

npm run check    # Lint, format, type check (requires build first)
./test.sh        # Run tests (skips LLM tests without API keys)

---

Documentation

📖 Full docs: jaeswift.xyz/agent/docs

• Getting Started
• Features Overview
• Configuration Guide
• Tools Reference
• Extensions Guide
• Venice AI Skills
• Marketplace
• Provider Setup
• CLI Commands

---

License

MIT

---

_{Built with 🔥 by JaeSwift}