11# Beginner FAQ
22
33This 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
99ollama serve
10- rexos init
10+ loopforge init
1111mkdir -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"
1313cat 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:
6363Example:
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
8383mkdir -p /tmp/rexos-work
84- rexos agent run --workspace /tmp/rexos-work --prompt " ..."
84+ loopforge agent run --workspace /tmp/rexos-work --prompt " ..."
8585```
8686
8787For 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:
115115Example:
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:
130130Suggested capture:
131131
132132``` bash
133- rexos doctor > doctor.txt
133+ loopforge doctor > doctor.txt
134134```
135135
136136## 10) Where should I continue learning?
0 commit comments