YapCLI v0.1.0

终端专用 Java Agent IDE

YapCLI 是一款基于 Java 17 的开源 Terminal-First Agent IDE。它将 ReAct 循环、Plan-and-Execute、Multi-Agent 协作、MCP 协议、浏览器自动化、WeChat iLink 集成在一个 JAR 中。

↓ 安装 GitHub Javadoc
24 Packages
208 Java Sources
7 LLM Providers
23 Phases Shipped
60+ MCP Tools
// capabilities

Core Capabilities

从 ReAct 循环到 MCP 协议 — 全部由 Java 17 实现

01

Multi-Agent System

三种模式：ReAct / Plan-and-Execute / Multi-Agent 协作。DAG 依赖解析、并行执行、质量审查。

ReActDAGOrchestratorHITL
02

MCP Protocol

stdio + Streamable HTTP 双传输。60+ 工具自动注册、resources @-mention。

stdioHTTPresourcesnotifications
03

Memory & RAG

短期/长期记忆、向量检索、代码索引。SQLite 内置向量存储。

长期记忆向量检索ASTEmbedding
04

Browser Automation

集成 Chrome DevTools MCP。导航、截图、点击、表单输入。

CDP会话复用SPA登录状态
05

Web + Search

web_search (3 providers) + web_fetch (readability 提取)。通过 MCP 集成 StepSearch。

搜索抓取Readability安全策略
06

WeChat iLink

微信 iLink 通道。非交互式策略、命令白名单、远程操控。

iLink远程操控非交互 HITLMQTT
07

Security & Audit

HITL 审批流、路径围栏、命令黑名单、操作审计日志。

HITLPathGuardAuditLog策略
08

TUI Productization

三种 Renderer（inline / lanterna / plain）。行内折叠、diff、状态栏。

JLineLanterna实时显示Markdown
09

LSP + Snapshot

自动收集编译诊断、Side-Git Turn 粒度快照和单击还原。

LSPSide-Git快照回滚
// execution modes

三种模式，一套引擎

共享 ToolRegistry / MemoryManager / SnapshotService，不创建孤立空会话。

默认

ReAct

单轮对话驱动的思考-行动-观察循环，适合日常编码、文件操作、快速问答。

* 直接输入任务
进阶

Plan & Execute

先规划后执行。复杂任务拆解为 DAG，按依赖顺序推进，支持审阅与补充。

/plan 创建 demo 项目...
协作

Multi-Agent

三人团队协作：规划者拆解、执行者实施、检查者审查。自动重试与冲突解决。

/team 重构 auth 模块
// multi-model

Multi-Model Support

5 个 LLM 提供方，运行时一键切换

GLM-5.1 /model glm-5.1
DeepSeek V3/V4 /model deepseek
StepFun /model step
Kimi K2.6 /model kimi
FreeLLMAPI /model freellmapi
Agnes /model agnes
// safety first

Agent 不可缺少的护栏

四层防线保护你的项目：HITL + 路径围栏 + 命令拒绝 + 审计日志。

🔒

Human-in-the-Loop

高危/中危操作分级审批，支持批准、全部放行、拒绝、跳过。

🛡️

PathGuard

文件类工具强制限定在项目根内，绝对路径外逃全部拦截。

🧯

Command Safe Deny

sudo / rm -rf / mkfs 等破坏性命令在 HITL 之前直接拦截。

📋

Audit Log

危险工具调用按天写 JSONL 审计，Token/Key 自动脱敏。

// architecture

Architecture

24 个包、3 条执行路径、清晰的层分离

CLI · TUI
→
Agent Core
Plan
Tool
Memory
RAG
Skill
HITL
MCP
Web
LLM
Context
Policy
Browser
Java 17MavenOkHttpJackson JLineSQLiteJavaParserJGit GLM-5.1DeepSeek V4StepFunMCP
// getting started

Installation

Java 17 + Maven — 3 分钟完成配置

1

配置 API Key

bash
# 复制 .env 并编辑
cp .env.example .env
GLM_API_KEY=your_key_here
2

编译与启动

bash
mvn clean package
java -jar target/yapcli-1.0-SNAPSHOT.jar
3

配置 WeChat iLink

bash
java -jar yapcli-1.0-SNAPSHOT.jar \
  wechat setup
// commands

CLI Commands

/planPlan-and-Execute
/teamMulti-Agent
/modelSwitch LLM
/mcpMCP management
/memoryMemory system
/skillSkill management
/browserBrowser session
/hitlHITL toggle
/indexCode indexing
/searchSemantic search
/saveSave memory
/exitExit