Sovereign 8s.is mirror of standardgalactic/opencode-agent-system
  • TypeScript 95.3%
  • JavaScript 4%
  • Shell 0.7%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Cogito Ergo Sum 0bd07625db
Some checks failed
ci.yml / Add scripts/manage.sh for repository lifecycle management (push) Failing after 0s
Add scripts/manage.sh for repository lifecycle management
2026-07-14 09:17:37 -03:00
.github/workflows fix(ci): remove static .npmrc from git, write it at runtime with GHA secret 2026-07-09 13:07:35 -04:00
apps/cli fix: correct published dependency versions for npm consumers (#40) 2026-07-09 14:50:07 -04:00
packages fix: correct published dependency versions for npm consumers (#40) 2026-07-09 14:50:07 -04:00
scripts Add scripts/manage.sh for repository lifecycle management 2026-07-14 09:17:37 -03:00
.gitignore Open source: make repo public and prepare for publication 2026-07-06 17:40:19 -04:00
AGENTS.md fix: final scrub of @opencode-* references across all docs and root package 2026-07-09 14:05:28 -04:00
LICENSE Open source: make repo public and prepare for publication 2026-07-06 17:40:19 -04:00
package.json fix: final scrub of @opencode-* references across all docs and root package 2026-07-09 14:05:28 -04:00
pnpm-lock.yaml fix(ci): commit pnpm-lock.yaml so CI can work without regenerating from scratch — lock file is the only GPR auth available in workflows 2026-07-09 13:07:35 -04:00
pnpm-workspace.yaml feat: fix TypeScript errors and extract skill service 2026-06-10 02:53:00 -04:00
README.md Update README with version badge and manage.sh usage 2026-07-14 09:17:20 -03:00
tsconfig.base.json feat: initial opencode-agent-system repository 2026-06-09 21:11:17 -04:00
tsconfig.json feat: fix TypeScript errors and extract skill service 2026-06-10 02:53:00 -04:00

@belarusian/agent-system

Version Tests License: MIT

What Is This?

A self-contained TypeScript agent platform: LLM client, tool system, agent loop with dual-model A* search, and a context-transfer bridge. Extract the pieces you need or use them all together.

Built on Effect v4, runs against any OpenAI-compatible LLM server (llama.cpp, vLLM, Ollama, etc.).

Repository Management Script

Use the built-in management script for common lifecycle operations:

scripts/manage.sh <command>

Commands

  • clean – remove build artifacts and local caches
  • build – install deps and build all packages
  • test – run test suites
  • typecheck – run type checks
  • run <mode> [-- ...args] – run in supported modes (cli, bridge, dev)
  • release – build and run release packaging when available
  • version <kind> – bump version (bump, minor, major)

Examples

scripts/manage.sh clean
scripts/manage.sh build
scripts/manage.sh run cli -- --help
scripts/manage.sh run bridge -- --help
scripts/manage.sh version minor

Packages

Package Purpose
@belarusian/harness LLM client + agent loop (self-contained)
@belarusian/tools 16 built-in tools: read, write, edit, shell, glob, grep, webfetch, etc.
@belarusian/agents Agent service with skills, subagents, and built-in presets
@belarusian/bridge Context-aware MoE↔dense conversation bridge
@belarusian/cli CLI for running agents standalone or as orchestrator workers

Installation

From source

pnpm install
pnpm build

As a third-party dependency

Packages are published to GitHub Packages under @belarusian scope. Add auth token:

echo "//npm.pkg.github.com/:_authToken=ghp_YOUR_TOKEN" >> ~/.npmrc
echo "@belarusian:registry=https://npm.pkg.github.com/" >> ~/.npmrc

Then install:

# Just the agent loop
pnpm add @belarusian/harness effect

# Agent loop + tools
pnpm add @belarusian/harness @belarusian/tools effect

# Full stack (agents)
pnpm add @belarusian/agents @belarusian/harness effect

Quick Start

CLI

opencode-agent run \
  --prompt "Build a REST API for user auth" \
  --model "qwen3-coder" \
  --url "http://localhost:8080/v1"

SDK

import { runAgent } from "@belarusian/harness";
import * as Effect from "effect/Effect";

const result = await Effect.runPromise(
  runAgent({
    config: { baseUrl: "http://localhost:8080/v1", model: "qwen3-coder" },
    messages: [{ role: "user", content: "Build a REST API" }],
    maxSteps: 5,
  }),
);

Development

pnpm install
pnpm build
pnpm test
pnpm typecheck

Testing

pnpm test  # 635 tests (harness 385 + tools 39 + agents 30 + bridge 181)

License

MIT