Skip to content

Commit 3410a9c

Browse files
author
Rex
committed
chore: finalize loopforge command migration sweep
1 parent 33ac321 commit 3410a9c

5 files changed

Lines changed: 50 additions & 45 deletions

File tree

docs-site/how-to/faq.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
# Beginner FAQ
22

33
This page is intentionally short and copy/paste-friendly.
4-
If you are blocked, run `rexos doctor` first.
4+
If you are blocked, run `loopforge doctor` first (`rexos doctor` remains compatible).
55

66
## 1) I installed RexOS. What is the minimum first run?
77

88
```bash
99
ollama serve
10-
rexos init
10+
loopforge init
1111
mkdir -p rexos-demo
12-
rexos agent run --workspace rexos-demo --prompt "Create hello.txt with the word hi"
12+
loopforge agent run --workspace rexos-demo --prompt "Create hello.txt with the word hi"
1313
cat rexos-demo/hello.txt
1414
```
1515

@@ -39,8 +39,8 @@ default_model = "qwen3:4b"
3939
## 3) How do I know config and dependencies are healthy?
4040

4141
```bash
42-
rexos config validate
43-
rexos doctor
42+
loopforge config validate
43+
loopforge doctor
4444
```
4545

4646
`doctor` should report:
@@ -63,7 +63,7 @@ Try:
6363
Example:
6464

6565
```bash
66-
rexos agent run --workspace rexos-demo --prompt "Read README.md and write notes/summary.md with 5 bullets."
66+
loopforge agent run --workspace rexos-demo --prompt "Read README.md and write notes/summary.md with 5 bullets."
6767
```
6868

6969
## 5) Why did a tool call fail with argument errors?
@@ -81,14 +81,14 @@ Always use a dedicated workspace and commit early:
8181

8282
```bash
8383
mkdir -p /tmp/rexos-work
84-
rexos agent run --workspace /tmp/rexos-work --prompt "..."
84+
loopforge agent run --workspace /tmp/rexos-work --prompt "..."
8585
```
8686

8787
For repository work, prefer harness:
8888

8989
```bash
90-
rexos harness init my-repo
91-
rexos harness run my-repo --prompt "Run tests and fix one failing case"
90+
loopforge harness init my-repo
91+
loopforge harness run my-repo --prompt "Run tests and fix one failing case"
9292
```
9393

9494
## 7) Browser + web tasks fail on specific sites. Is that a bug?
@@ -115,7 +115,7 @@ Verification command:
115115
Example:
116116

117117
```bash
118-
rexos agent run --workspace rexos-demo --prompt "Goal: summarize Cargo.toml dependencies. Output file: notes/deps.md. Constraints: 8 bullets max. Verification: file must exist."
118+
loopforge agent run --workspace rexos-demo --prompt "Goal: summarize Cargo.toml dependencies. Output file: notes/deps.md. Constraints: 8 bullets max. Verification: file must exist."
119119
```
120120

121121
## 9) What should I include in a bug report?
@@ -130,7 +130,7 @@ Include:
130130
Suggested capture:
131131

132132
```bash
133-
rexos doctor > doctor.txt
133+
loopforge doctor > doctor.txt
134134
```
135135

136136
## 10) Where should I continue learning?

docs-site/tutorials/quickstart-ollama.md

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Quickstart (Ollama)
22

3-
This tutorial runs RexOS locally using Ollama’s OpenAI-compatible endpoint.
3+
This tutorial runs LoopForge locally using Ollama’s OpenAI-compatible endpoint.
44

55
## Prerequisites
66

@@ -13,7 +13,7 @@ Check your local models:
1313
ollama list
1414
```
1515

16-
RexOS defaults to `providers.ollama.default_model = "llama3.2"` in `~/.rexos/config.toml`.
16+
LoopForge defaults to `providers.ollama.default_model = "llama3.2"` in `~/.rexos/config.toml`.
1717

1818
If you don’t have `llama3.2` installed, pick one of these:
1919

@@ -23,7 +23,7 @@ If you don’t have `llama3.2` installed, pick one of these:
2323
ollama pull llama3.2
2424
```
2525

26-
2) Or switch RexOS to a model you already have (example: `qwen3:4b`):
26+
2) Or switch LoopForge to a model you already have (example: `qwen3:4b`):
2727

2828
```toml
2929
[providers.ollama]
@@ -36,40 +36,42 @@ default_model = "qwen3:4b"
3636
ollama serve
3737
```
3838

39-
## 2) Initialize RexOS
39+
## 2) Initialize LoopForge
4040

4141
This creates:
4242
- `~/.rexos/config.toml` (provider config + routing)
4343
- `~/.rexos/rexos.db` (SQLite memory)
4444

4545
```bash
46-
rexos init
46+
loopforge init
4747
```
4848

49+
Compatibility: `rexos init` still works during migration.
50+
4951
## 3) Run your first agent session
5052

5153
Pick a workspace directory (tools are sandboxed to this root):
5254

5355
=== "macOS/Linux"
5456
```bash
5557
mkdir -p rexos-work
56-
rexos agent run --workspace rexos-work --prompt "Create hello.txt with the word hi"
58+
loopforge agent run --workspace rexos-work --prompt "Create hello.txt with the word hi"
5759
cat rexos-work/hello.txt
5860
```
5961

6062
=== "Windows (PowerShell)"
6163
```powershell
6264
mkdir rexos-work
63-
rexos agent run --workspace rexos-work --prompt "Create hello.txt with the word hi"
65+
loopforge agent run --workspace rexos-work --prompt "Create hello.txt with the word hi"
6466
Get-Content .\rexos-work\hello.txt
6567
```
6668

67-
RexOS prints the final assistant output, and persists a stable `session_id` under `rexos-work/.rexos/session_id`.
69+
LoopForge prints the final assistant output, and persists a stable `session_id` under `rexos-work/.rexos/session_id`.
6870

6971
## 4) Re-run in the same workspace (optional)
7072

7173
```bash
72-
rexos agent run --workspace rexos-work --prompt "Now append a newline + bye to hello.txt"
74+
loopforge agent run --workspace rexos-work --prompt "Now append a newline + bye to hello.txt"
7375
```
7476

7577
## Next steps

docs-site/zh-CN/how-to/faq.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
# 新手 FAQ
22

33
这页是给新手准备的“短答案 + 可复制命令”。
4-
如果你卡住,先跑一遍 `rexos doctor`
4+
如果你卡住,先跑一遍 `loopforge doctor``rexos doctor` 仍兼容)
55

66
## 1)刚安装完,最小可运行流程是什么?
77

88
```bash
99
ollama serve
10-
rexos init
10+
loopforge init
1111
mkdir -p rexos-demo
12-
rexos agent run --workspace rexos-demo --prompt "Create hello.txt with the word hi"
12+
loopforge agent run --workspace rexos-demo --prompt "Create hello.txt with the word hi"
1313
cat rexos-demo/hello.txt
1414
```
1515

@@ -39,8 +39,8 @@ default_model = "qwen3:4b"
3939
## 3)怎么快速判断环境健康?
4040

4141
```bash
42-
rexos config validate
43-
rexos doctor
42+
loopforge config validate
43+
loopforge doctor
4444
```
4545

4646
`doctor` 里至少应看到:
@@ -63,7 +63,7 @@ rexos doctor
6363
示例:
6464

6565
```bash
66-
rexos agent run --workspace rexos-demo --prompt "Read README.md and write notes/summary.md with 5 bullets."
66+
loopforge agent run --workspace rexos-demo --prompt "Read README.md and write notes/summary.md with 5 bullets."
6767
```
6868

6969
## 5)为什么会报“tool arguments/JSON 参数错误”?
@@ -81,17 +81,17 @@ rexos agent run --workspace rexos-demo --prompt "Read README.md and write notes/
8181

8282
```bash
8383
mkdir -p /tmp/rexos-work
84-
rexos agent run --workspace /tmp/rexos-work --prompt "..."
84+
loopforge agent run --workspace /tmp/rexos-work --prompt "..."
8585
```
8686

8787
仓库改动建议走 harness:
8888

8989
```bash
90-
rexos harness init my-repo
91-
rexos harness run my-repo --prompt "Run tests and fix one failing case"
90+
loopforge harness init my-repo
91+
loopforge harness run my-repo --prompt "Run tests and fix one failing case"
9292
```
9393

94-
## 7)浏览器任务在某些网站失败,是不是 RexOS 坏了?
94+
## 7)浏览器任务在某些网站失败,是不是 LoopForge 坏了?
9595

9696
不一定。部分网站存在反爬与动态渲染,页面结构会波动。
9797

@@ -115,7 +115,7 @@ Verification command:
115115
示例:
116116

117117
```bash
118-
rexos agent run --workspace rexos-demo --prompt "Goal: summarize Cargo.toml dependencies. Output file: notes/deps.md. Constraints: 8 bullets max. Verification: file must exist."
118+
loopforge agent run --workspace rexos-demo --prompt "Goal: summarize Cargo.toml dependencies. Output file: notes/deps.md. Constraints: 8 bullets max. Verification: file must exist."
119119
```
120120

121121
## 9)提 bug 时需要哪些信息?
@@ -130,7 +130,7 @@ rexos agent run --workspace rexos-demo --prompt "Goal: summarize Cargo.toml depe
130130
建议附带:
131131

132132
```bash
133-
rexos doctor > doctor.txt
133+
loopforge doctor > doctor.txt
134134
```
135135

136136
## 10)下一步学什么?

docs-site/zh-CN/tutorials/quickstart-ollama.md

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# 快速开始(Ollama)
22

3-
本教程用 Ollama 的 OpenAI 兼容接口在本地跑通 RexOS
3+
本教程用 Ollama 的 OpenAI 兼容接口在本地跑通 LoopForge
44

55
## 前置条件
66

@@ -13,7 +13,7 @@
1313
ollama list
1414
```
1515

16-
默认情况下,RexOS 会在 `~/.rexos/config.toml` 里使用:
16+
默认情况下,LoopForge 会在 `~/.rexos/config.toml` 里使用:
1717

1818
- `providers.ollama.default_model = "llama3.2"`
1919

@@ -25,7 +25,7 @@ ollama list
2525
ollama pull llama3.2
2626
```
2727

28-
2) 或把 RexOS 切到你已经有的模型(例:`qwen3:4b`):
28+
2) 或把 LoopForge 切到你已经有的模型(例:`qwen3:4b`):
2929

3030
```toml
3131
[providers.ollama]
@@ -38,40 +38,42 @@ default_model = "qwen3:4b"
3838
ollama serve
3939
```
4040

41-
## 2) 初始化 RexOS
41+
## 2) 初始化 LoopForge
4242

4343
会创建:
4444
- `~/.rexos/config.toml`
4545
- `~/.rexos/rexos.db`
4646

4747
```bash
48-
rexos init
48+
loopforge init
4949
```
5050

51+
兼容说明:迁移期间 `rexos init` 仍可继续使用。
52+
5153
## 3) 运行第一次 session
5254

5355
工具调用会被沙盒限制在 `--workspace` 目录内:
5456

5557
=== "macOS/Linux"
5658
```bash
5759
mkdir -p rexos-work
58-
rexos agent run --workspace rexos-work --prompt "Create hello.txt with the word hi"
60+
loopforge agent run --workspace rexos-work --prompt "Create hello.txt with the word hi"
5961
cat rexos-work/hello.txt
6062
```
6163

6264
=== "Windows (PowerShell)"
6365
```powershell
6466
mkdir rexos-work
65-
rexos agent run --workspace rexos-work --prompt "Create hello.txt with the word hi"
67+
loopforge agent run --workspace rexos-work --prompt "Create hello.txt with the word hi"
6668
Get-Content .\rexos-work\hello.txt
6769
```
6870

69-
RexOS 会输出最终回答,并把稳定的 `session_id` 持久化到 `rexos-work/.rexos/session_id`
71+
LoopForge 会输出最终回答,并把稳定的 `session_id` 持久化到 `rexos-work/.rexos/session_id`
7072

7173
## 4) 在同一个 workspace 里续跑(可选)
7274

7375
```bash
74-
rexos agent run --workspace rexos-work --prompt "Now append a newline + bye to hello.txt"
76+
loopforge agent run --workspace rexos-work --prompt "Now append a newline + bye to hello.txt"
7577
```
7678

7779
## 下一步

init.sh

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,15 @@
11
#!/usr/bin/env bash
22
set -euo pipefail
33

4-
echo "[rexos] building..."
4+
echo "[loopforge] building..."
55
cargo build
66

7-
echo "[rexos] tests..."
7+
echo "[loopforge] tests..."
88
cargo test
99

10-
echo "[rexos] smoke: CLI help"
10+
echo "[loopforge] smoke: CLI help"
1111
cargo build -p rexos-cli
12+
./target/debug/loopforge --help >/dev/null
1213
./target/debug/rexos --help >/dev/null
1314

14-
echo "[rexos] done"
15+
echo "[loopforge] done"

0 commit comments

Comments
 (0)