Sovereign 8s.is mirror of standardgalactic/opencode-agent-system
- TypeScript 95.3%
- JavaScript 4%
- Shell 0.7%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
Some checks failed
ci.yml / Add scripts/manage.sh for repository lifecycle management (push) Failing after 0s
|
||
| .github/workflows | ||
| apps/cli | ||
| packages | ||
| scripts | ||
| .gitignore | ||
| AGENTS.md | ||
| LICENSE | ||
| package.json | ||
| pnpm-lock.yaml | ||
| pnpm-workspace.yaml | ||
| README.md | ||
| tsconfig.base.json | ||
| tsconfig.json | ||
@belarusian/agent-system
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 cachesbuild– install deps and build all packagestest– run test suitestypecheck– run type checksrun <mode> [-- ...args]– run in supported modes (cli,bridge,dev)release– build and run release packaging when availableversion <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