You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 24b586b
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: README.md
+5-6Lines changed: 5 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,8 +11,7 @@ Roboppi (ろぼっぴ, pronounced "roh-boh-pee") is an execution-control runtime
11
11
It does not try to be "the agent". It enforces safety invariants around external worker CLIs (OpenCode / Claude Code / Codex CLI / plain shell), so your automation stops when it should, stays within budgets, and leaves a trail you can audit.
12
12
13
13
Note: the primary CLI/binary name is `roboppi`.
14
-
- Compatibility: `agentcore` remains as a legacy alias.
15
-
- Env vars/state dirs: prefer `ROBOPPI_` / `.roboppi-loop/` (legacy `AGENTCORE_` / `.agentcore-loop/` are still accepted).
14
+
- Env vars/state dirs: use `ROBOPPI_` / `.roboppi-loop/`.
16
15
17
16
## What Roboppi Can Do (Capabilities)
18
17
@@ -191,7 +190,7 @@ ROBOPPI_ROOT="$ROBOPPI_ROOT" bun run --cwd "$ROBOPPI_ROOT" src/workflow/run.ts \
191
190
192
191
Notes:
193
192
194
-
- The workflow writes state/artifacts under `.roboppi-loop/` and `context/` inside the target workspace (typically gitignored; legacy `.agentcore-loop/` is still accepted).
193
+
- The workflow writes state/artifacts under `.roboppi-loop/` and `context/` inside the target workspace (typically gitignored).
195
194
- PR creation is opt-in via `.roboppi-loop/enable_pr`.
196
195
197
196
## Workflow YAML At A Glance
@@ -273,9 +272,9 @@ Docs:
273
272
Workflows/daemon run supervised by default. In supervised mode, the runner starts a Core child process and delegates steps over IPC.
274
273
275
274
- Default: interactive runs typically use stdio; non-interactive runs default to a socket transport.
Copy file name to clipboardExpand all lines: docs/design.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -121,19 +121,19 @@ Workers provide execution environments and capabilities. AgentCore calls them th
121
121
```
122
122
Scheduler (parent)
123
123
|
124
-
+-- spawn(agentcore, args...)
124
+
+-- spawn(roboppi, args...)
125
125
+-- JSON Lines IPC over stdin/stdout
126
126
+-- periodic heartbeat/health monitoring
127
127
|
128
-
+-> AgentCore (child)
128
+
+-> Roboppi Core (child)
129
129
+-- processes externally submitted jobs
130
130
+-- issues permits and delegates to workers
131
131
+-- observes, limits, cuts off, escalates
132
132
```
133
133
134
-
The Scheduler spawns AgentCore as a child process, keeps stdin/stdout open, and uses **JSON Lines** for bidirectional communication. It monitors response latency via heartbeat and checks memory/CPU thresholds periodically.
134
+
The Scheduler spawns Roboppi Core as a child process, keeps stdin/stdout open, and uses **JSON Lines** for bidirectional communication. It monitors response latency via heartbeat and checks memory/CPU thresholds periodically.
135
135
136
-
AgentCore behaves as a runtime that processes "jobs given from outside", issues Permits, and spawns/uses workers as needed.
136
+
Roboppi Core behaves as a runtime that processes "jobs given from outside", issues Permits, and spawns/uses workers as needed.
If your workflows use `step.agent`, provide an agent catalog to the daemon:
134
134
135
135
-`agents_file`: a default catalog path for the daemon (relative paths are resolved from `workspace`)
136
-
-`AGENTCORE_AGENTS_FILE`: you can also set this via environment variables (or per-trigger via `triggers.<id>.context.env`) as a colon-separated list of YAML paths
136
+
-`ROBOPPI_AGENTS_FILE`: you can also set this via environment variables (or per-trigger via `triggers.<id>.context.env`) as a colon-separated list of YAML paths
137
137
138
-
When multiple catalogs are provided, later sources override earlier ones (so a per-trigger `context.env.AGENTCORE_AGENTS_FILE` can override the daemon-wide catalog).
138
+
When multiple catalogs are provided, later sources override earlier ones (so a per-trigger `context.env.ROBOPPI_AGENTS_FILE` can override the daemon-wide catalog).
139
139
140
140
See also: `docs/guides/agents.md`.
141
141
@@ -703,8 +703,8 @@ name: simple-cron
703
703
version: "1"
704
704
description: "A simple daemon that runs health checks every 30 seconds"
Copy file name to clipboardExpand all lines: docs/guide/quickstart.md
+21-21Lines changed: 21 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
-
# AgentCore Quickstart
1
+
# Roboppi Quickstart
2
2
3
-
AgentCore is an execution-control runtime for AI agent systems. It provides safe execution control via Permits, failure cut-off via Circuit Breakers, and delegation of actual work to external Workers.
3
+
Roboppi is an execution-control runtime for AI agent systems. It provides safe execution control via Permits, failure cut-off via Circuit Breakers, and delegation of actual work to external Workers.
4
4
5
5
## Prerequisites
6
6
@@ -19,22 +19,22 @@ Optional (if you plan to use them as workers):
19
19
## Install
20
20
21
21
```bash
22
-
git clone <repository-url>agentcore
23
-
cdagentcore
22
+
git clone <repository-url>roboppi
23
+
cdroboppi
24
24
bun install
25
25
```
26
26
27
27
## Build
28
28
29
29
```bash
30
-
make # build a single binary -> ./roboppi (+ ./agentcore alias)
30
+
make # build a single binary -> ./roboppi
31
31
```
32
32
33
33
Sanity check:
34
34
35
35
```bash
36
-
./agentcore --version
37
-
./agentcore --help
36
+
./roboppi --version
37
+
./roboppi --help
38
38
```
39
39
40
40
Other make targets:
@@ -48,23 +48,23 @@ make install # install to /usr/local/bin
48
48
49
49
---
50
50
51
-
## Usage 1: One-shot execution with `agentcore run`
51
+
## Usage 1: One-shot execution with `roboppi run`
52
52
53
53
Use the `run` subcommand to delegate a task to a Worker using only CLI flags.
54
54
55
55
```bash
56
56
# Generate files with OpenCode
57
-
./agentcore run --worker opencode --workspace /tmp/demo "Create hello.ts"
57
+
./roboppi run --worker opencode --workspace /tmp/demo "Create hello.ts"
58
58
59
59
# Fix tests with Claude Code
60
-
./agentcore run --worker claude-code --workspace ./my-project \
60
+
./roboppi run --worker claude-code --workspace ./my-project \
61
61
--capabilities EDIT,RUN_TESTS "Fix the failing tests"
62
62
63
63
# Refactor with Codex CLI
64
-
./agentcore run --worker codex --workspace ./src "Refactor this function"
64
+
./roboppi run --worker codex --workspace ./src "Refactor this function"
65
65
66
66
# You can also set timeouts and budgets
67
-
./agentcore run --worker opencode --workspace /tmp/demo \
67
+
./roboppi run --worker opencode --workspace /tmp/demo \
68
68
--timeout 60000 --concurrency 5 "Write a README for this repo"
69
69
```
70
70
@@ -77,20 +77,20 @@ Use the `run` subcommand to delegate a task to a Worker using only CLI flags.
0 commit comments