# f-cli

**Repository Path**: alimei/f-cli

## Basic Information

- **Project Name**: f-cli
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: stage/10-cli-productization
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-11
- **Last Updated**: 2026-08-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# F-CLI

F-CLI 是一个使用 AgentScope Java 2 构建的渐进式 coding agent CLI，目标是逐步实现类似 Claude Code 的项目协作体验。

## 环境要求

- JDK 17+
- Maven 3.9+
- 一个 OpenAI 兼容的模型服务

## 配置

不要把 API Key 写进代码或提交到 Git。复制 `.env.example` 中的变量到当前 shell：

```bash
export FCLI_API_KEY='your-api-key'
export FCLI_BASE_URL='https://app.runcode.win'
export FCLI_MODEL='your-model-name'
```

## 运行

```bash
export JAVA_HOME=$HOME/Library/Java/JavaVirtualMachines/azul-21.0.7/Contents/Home
mvn compile exec:java
```

当前版本为阶段 10：支持 OpenAI 兼容模型、流式对话、工具、权限、会话、记忆、受限执行、Skill、Subagent 和 Plan Mode。每个阶段的目标、实现内容和验收方式见 `docs/stages/`。

## 学习与实现路线

1. 最小 Agent 与流式输出
2. 文件和 Shell 工具
3. 权限确认与中断
4. Workspace、会话和状态恢复
5. 记忆与上下文压缩
6. Sandbox
7. Skill
8. Subagent
9. Plan Mode
10. CLI 产品化