image	https://raw.githubusercontent.com/iamGodofall/edge-run/main/ABSuite%20image.jpeg
twitter:image	https://raw.githubusercontent.com/iamGodofall/edge-run/main/ABSuite%20image.jpeg
og:image	https://raw.githubusercontent.com/iamGodofall/edge-run/main/ABSuite%20image.jpeg

edge-run v0.1.0 - Offline-First Agent Orchestrator

Local-first agent scheduling & runtime. Zero cloud. Runs on your machine only.

Quick Start

npm install
npm run demo  # See working example
npm test      # Run units

Usage

import { schedule, run, syncState } from 'edge-run';

// Schedule agent job
const job = await schedule({
  agent: { id: 'my-agent', type: 'node', entrypoint: './my-agent.js' },
  trigger: 'immediate',
  input: { data: 'hello' }
});

// Run agent directly
const result = await run(job.agent, job.input);
console.log(result.output);

// Sync (MVP sim)
await syncState();

API

• schedule(options: ScheduleOptions): Queue with resource/trigger checks
• cancel(jobId: string)
• status(jobId: string)
• run(agent: AgentConfig, input: unknown)
• syncState(options?)

See /demo for examples. Full types in src/types.ts.

Local-First Principles

• All data stays local
• Resource-aware scheduling (CPU/Mem/Battery)
• Triggers: immediate, daily, on-wifi/charge (sim)
• Isolated runtime (subprocess)

Development

npm run build  # tsc
npm run dev    # ts-node src/index.ts

MIT License. v0.1.0 MVP shipped! 🚀

---

Part of the Agent Builder Suite
→ capkit: Scoped capabilities for agents
→ quickbench: Reproducible agent evaluation
→ edge-run: Offline-first orchestration
→ connector-starter: Generate adapters fast (coming soon)

Built for builders who ship. MIT licensed. Local-first by design.