使用说明
⚠️ 已弃用 --该项目已被取代 wiseowl cli (Java 21+Micronaut)。所有功能都已整合到新项目中。此存储库已存档,将不再接收更新。
🦉 OCLI-Ollama命令行界面
🦉 OCLI-Ollama命令行界面
一个类似Claude Code的AI编码助手,具有自我改进功能、LCARS Star Trek风格和完整的终端UI控制。
✨ 特性
🤖 人工智能驱动开发
- 自主工具调用 -AI自动使用工具读取/写入文件,执行命令
- 流媒体响应 -带有进度指标的实时输出
- 上下文感知 -维护对话历史和文件上下文
- 自我提升 -可以读取和修改自己的源代码
🛠️ 内置工具
read_file-读取任何具有语法意识的文件write_file-使用自动备份创建/修改文件execute_bash-安全运行shell命令search_files-在项目中查找文件和内容list_directory-探索目录结构
📋 规划模式
/plan-创建人工智能生成的分步计划/next-执行计划中的下一步/show-plan-查看计划进度
🔧 项目管理(WiseOwl)
- 自动创建
wiseowl/项目跟踪文件夹 /todo-将任务添加到TODO.md/done-标记任务已完成/rule-将项目规则添加到rules.md/context-向context.md添加上下文
🎨 LCARS接口
- 真正的《星际迷航》LCARS造型
- RGB颜色为51的倍数(十六进制33)
- 状态指示器:● (蓝色=成功,红色=错误,紫色=信息,黄色=警告)
- 高对比度的干净矢量外观
📊 终端用户界面
/monitor-全屏实时统计(如top/htop)- 光标定位和颜色控制
- 备用缓冲区支持
🔌 MCP(模型上下文协议)支持
看 MCP架构文件 了解详细的部署选项。
- 加载外部MCP服务器以实现扩展功能
/mcp list-显示可用的MCP工具/mcp call <tool> [params]-调用MCP工具- AI自动知道可用的MCP工具
- 在中配置服务器
.ocli/mcp_servers.json
⚙️ 配置和导出
/config set <key> <value>-设置配置/config get <key>-获取配置值/config list-显示所有设置/export [filename]-将对话导出到markdown
📈 统计和Git
/stats-显示会话统计信息/git status|diff|log|commit-Git集成/version-显示OCLI版本
🚀 安装
来源
git clone https://github.com/wiseowltechnet/ollama-ocli.git
cd ollama-ocli
cargo build --release
./target/release/ocli
自制(macOS/Linux)
brew tap wiseowltechnet/ocli
brew install ocli
📖 快速开始
- 启动OCLI
ocli
- 请求AI提供帮助
You: create a hello world rust program
- 对复杂任务使用计划模式
You: /plan build a web server with authentication
You: /next
- 监控您的会话
You: /monitor
- 配置MCP服务器
mkdir -p .ocli
cat > .ocli/mcp_servers.json << JSON
{
"servers": [
{
"name": "filesystem",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
}
]
}
JSON
🎯 用例
自我完善
OCLI可以自行修改:
You: add a /version command to show OCLI version
AI: *reads src/main.rs, adds version command, rebuilds*
项目脚手架
You: /plan create a REST API with user authentication
You: /next
代码审查
You: review the code in src/main.rs for potential issues
调试
You: the tests are failing, can you fix them?
📝 斜杠命令
| 命令 | 描述 |
|---|---|
/help |
显示所有命令 |
/plan <task> |
制定分步计划 |
/next |
执行下一个计划步骤 |
/show-plan |
查看计划进度 |
/read <file> |
读取文件 |
/write <file> |
写入文件 |
/preview |
预览待定更改 |
/apply |
应用待定更改 |
/rollback |
撤消上次更改 |
/todo <task> |
添加待办事项 |
/done <id> |
标记所有完成 |
/rule <rule> |
添加项目规则 |
/context <info> |
添加上下文 |
/mcp list |
列出MCP工具 |
/mcp call <tool> |
调用MCP工具 |
/config <cmd> |
管理设置 |
/export [file] |
导出对话 |
/stats |
显示统计信息 |
/git <cmd> |
Git操作 |
/monitor |
实时监控 |
/version |
显示版本 |
/clear |
清晰的上下文 |
/exit 退出OCLI。 |
🎨 LCARS颜色
- 橙子 (#FF9900)-页眉、边框
- 紫色 (#CC99FF)-会话信息
- 蓝色 (#99CCFF)-成功指标
- 黄色 (#FFCC00)-警告
- 红 (#FF6666)-错误
🔧 配置
OCLI将配置存储在 .ocli/:
config.json-用户设置mcp_servers.json-MCP服务器配置sessions/-对话历史
🤝 贡献
OCLI旨在自我改进。你可以:
- 要求OCLI为其自身添加功能
- 提交具有新功能的PR
- 创建MCP服务器以实现扩展功能
📜 许可证
麻省理工学院
🙏 致谢
- 建于 奥拉玛
- 受Claude Code启发
- 《星际迷航》中的LCARS设计
- MCP协议支持
由...制作🦉 OCLI社区
开发与质量保证
OCLI使用类似于Gradle的专业QA工具:
# Format code (like Spotless)
make fmt
# Lint code (like Checkstyle/SpotBugs)
make lint
# Run tests (like JUnit)
make test
# Full QA pipeline
make qa
# CI pipeline
make ci
看 QA_TOOLS.md 完整的指南。