Skip to content
Shahryar Sabir Muhammed
Shahryar Sabir
Software & AI Engineer
← Back to Systems
Solo Engineered
TypeScriptAutonomous AgentsCloudflareMCPACPRunnersPWAAI/ML

Zagros — Open Agent Operating System

The open-source operating system and runtime for persistent AI agents that keep working across laptop closes, serverless clouds, and distributed machine runners.

View GitHub Repository Inquire / Collaborate
$ git clone https://github.com/RegaLabs/ZagrosAI.git && cd ZagrosAI && pnpm install

Zagros: The Open-Source Runtime for Persistent AI Agents

Zagros is an open-source operating system and runtime for persistent AI agents. Use any model. Connect any MCP tool. Run locally, serverlessly, or across distributed machines. Close your laptop and let cloud-capable work continue uninterrupted.

  • GitHub Repository: RegaLabs/ZagrosAI
  • Architecture Model: Durable State Machines + Hybrid Cloud/Runner Protocol + MCP/ACP/A2A Open Standards
  • Platforms: Node.js 22+, Cloudflare Workers/Workflows, Local Runner daemons, Mobile PWA
Any Model + MCP Tools + Skills + Distributed Runners + Serverless Cloud = Zagros

Core Architecture Pillars

1. Persistent State Machines & Task Durability

A chatbot returns an answer and forgets. Zagros owns a durable lifecycle:

Task Request → Plan → Execute → Wait → Recover → Ask Permission → Continue → Verify → Deliver Artifacts

Tasks are durable state machines replicated across SQLite / D1 and object storage (R2/S3), surviving server restarts, machine transitions, and network interruptions.

2. Hybrid Execution & Zagros Runners

  • Always-on Cloud: Serverless execution (Cloudflare Workflows) executes orchestration, scheduling, webhooks, and cloud API integrations continuously.
  • Local Runners: Lightweight desktop daemons connect securely via WebSockets to execute browser automation (Playwright/Puppeteer), shell commands, local filesystem access, and hardware GPU tasks.
  • Laptop-Close Resiliency: When a machine goes offline, only hardware-specific steps pause — all cloud tasks continue, and tasks resume as soon as any compatible runner reconnects.

3. Open Protocols First (MCP, ACP, A2A)

  • Model Context Protocol (MCP): Native stdio and HTTP MCP server bindings with OAuth 2.1 authorization flows.
  • Agent Client Protocol (ACP): Bridges to provider-native coding harnesses (Claude Code, Codex, Gemini CLI) while respecting provider security boundaries.
  • Agent-to-Agent (A2A): Hierarchical agent delegation, parallel subtask dispatching, and agent card discovery.

4. Signed Skills & Cryptographic Audit Trails

  • SKILL.md Standard: Modular, auditable capability packages with parameter schema validation.
  • Security Hardening: Prompt-injection defenses, credential secret redaction, and SHA-256 tamper-evident execution audit chains.

Quick Start

# Clone and install monorepo dependencies
git clone https://github.com/RegaLabs/ZagrosAI.git
cd ZagrosAI
pnpm install

# Start local server and PWA
pnpm dev

# Build and connect a local desktop runner
pnpm --filter @zagros/runner build
pnpm --filter @zagros/runner start

System Specifications

0
E
1
n
2
g
3
i
4
n
5
e
6
e
7
r
8
e
9
d
10
11
Z
12
a
13
g
14
r
15
o
16
s
17
18
a
19
s
20
21
a
22
n
23
24
o
25
p
26
e
27
n
28
-
29
s
30
o
31
u
32
r
33
c
34
e
35
36
o
37
p
38
e
39
r
40
a
41
t
42
i
43
n
44
g
45
46
s
47
y
48
s
49
t
50
e
51
m
52
53
f
54
o
55
r
56
57
p
58
e
59
r
60
s
61
i
62
s
63
t
64
e
65
n
66
t
67
68
A
69
I
70
71
a
72
g
73
e
74
n
75
t
76
s
77
.
78
79
D
80
e
81
l
82
i
83
v
84
e
85
r
86
s
87
88
d
89
u
90
r
91
a
92
b
93
l
94
e
95
96
s
97
t
98
a
99
t
100
e
101
102
m
103
a
104
c
105
h
106
i
107
n
108
e
109
s
110
111
w
112
h
113
e
114
r
115
e
116
117
a
118
g
119
e
120
n
121
t
122
123
t
124
a
125
s
126
k
127
s
128
129
s
130
u
131
r
132
v
133
i
134
v
135
e
136
137
l
138
a
139
p
140
t
141
o
142
p
143
144
s
145
l
146
e
147
e
148
p
149
s
150
,
151
152
s
153
e
154
r
155
v
156
e
157
r
158
159
r
160
e
161
s
162
t
163
a
164
r
165
t
166
s
167
,
168
169
a
170
n
171
d
172
173
m
174
a
175
c
176
h
177
i
178
n
179
e
180
181
l
182
o
183
s
184
s
185
.
186
187
F
188
e
189
a
190
t
191
u
192
r
193
e
194
s
195
196
h
197
y
198
b
199
r
200
i
201
d
202
203
l
204
o
205
c
206
a
207
l
208
/
209
c
210
l
211
o
212
u
213
d
214
215
e
216
x
217
e
218
c
219
u
220
t
221
i
222
o
223
n
224
,
225
226
s
227
t
228
a
229
n
230
d
231
a
232
r
233
d
234
235
M
236
o
237
d
238
e
239
l
240
241
C
242
o
243
n
244
t
245
e
246
x
247
t
248
249
P
250
r
251
o
252
t
253
o
254
c
255
o
256
l
257
258
(
259
M
260
C
261
P
262
)
263
264
t
265
o
266
o
267
l
268
269
b
270
i
271
n
272
d
273
i
274
n
275
g
276
s
277
278
w
279
i
280
t
281
h
282
283
O
284
A
285
u
286
t
287
h
288
289
2
290
.
291
1
292
,
293
294
A
295
g
296
e
297
n
298
t
299
300
C
301
l
302
i
303
e
304
n
305
t
306
307
P
308
r
309
o
310
t
311
o
312
c
313
o
314
l
315
316
(
317
A
318
C
319
P
320
)
321
322
b
323
r
324
i
325
d
326
g
327
e
328
s
329
330
t
331
o
332
333
p
334
r
335
o
336
v
337
i
338
d
339
e
340
r
341
-
342
n
343
a
344
t
345
i
346
v
347
e
348
349
a
350
g
351
e
352
n
353
t
354
s
355
356
(
357
C
358
l
359
a
360
u
361
d
362
e
363
364
C
365
o
366
d
367
e
368
,
369
370
C
371
o
372
d
373
e
374
x
375
,
376
377
G
378
e
379
m
380
i
381
n
382
i
383
384
C
385
L
386
I
387
)
388
,
389
390
A
391
2
392
A
393
394
m
395
u
396
l
397
t
398
i
399
-
400
a
401
g
402
e
403
n
404
t
405
406
d
407
e
408
l
409
e
410
g
411
a
412
t
413
i
414
o
415
n
416
,
417
418
m
419
o
420
b
421
i
422
l
423
e
424
-
425
f
426
i
427
r
428
s
429
t
430
431
i
432
n
433
s
434
t
435
a
436
l
437
l
438
a
439
b
440
l
441
e
442
443
P
444
W
445
A
446
447
i
448
n
449
t
450
e
451
r
452
f
453
a
454
c
455
e
456
,
457
458
s
459
i
460
g
461
n
462
e
463
d
464
465
S
466
K
467
I
468
L
469
L
470
.
471
m
472
d
473
474
r
475
u
476
n
477
t
478
i
479
m
480
e
481
482
c
483
a
484
p
485
a
486
b
487
i
488
l
489
i
490
t
491
i
492
e
493
s
494
,
495
496
a
497
n
498
d
499
500
c
501
r
502
y
503
p
504
t
505
o
506
g
507
r
508
a
509
p
510
h
511
i
512
c
513
514
a
515
u
516
d
517
i
518
t
519
520
l
521
o
522
g
523
s
524
525
v
526
e
527
r
528
i
529
f
530
i
531
e
532
d
533
534
a
535
c
536
r
537
o
538
s
539
s
540
541
1
542
0
543
544
e
545
n
546
d
547
-
548
t
549
o
550
-
551
e
552
n
553
d
554
555
m
556
i
557
l
558
e
559
s
560
t
561
o
562
n
563
e
564
565
t
566
e
567
s
568
t
569
570
g
571
a
572
u
573
n
574
t
575
l
576
e
577
t
578
s
579
.

Need this in production?

I build and deploy custom speech AI models and persistent agent systems for businesses and teams.

Schedule Architecture Call →
← Previous System Reguant Next System → arch-guard