⚡ terminal-first · AI coding harness

Use the terminal as usual,
AI observes from behind.

You still cd, code, build, and test from the CLI. AI agents (omp) follow project context, load agents/* memory, and execute tasks on demand.

View on GitHub → Quick start Community

Terminal-first

No separate “AI terminal”. Your existing CLI workflow stays untouched — 8sync just wraps around it.

Dashboard CRUD

8sync harness web opens a local page to view & edit the whole agent-team: models, skills, memory, rules, engines, codebase graph — written straight to config.

Context-aware

Whichever project you enter, the AI picks up its context. Memory is shared via AGENTS.md + agents/*. 8sync harness builds it all with one command.

Skill injection

35 skills bundled. 8sync skill add <github-url> clones into both the global ~/.omp/skills/ and the project's agents/skills/.

Quick start

CachyOS / Arch Linux, Kitty terminal (enable allow_remote_control yes for the 3-pane layout).

bash 
# 1. Install — one-liner, prebuilt binary (NO git/rust/cargo needed)
curl -fsSL https://raw.githubusercontent.com/8-Sync-Dev/su-code/main/install.sh | sh
8sync setup                      # AI core: omp + codegraph + MCP/skills + gh (y/N per profile)
8sync doctor                     # verify

# 2. Enter a project → build the harness with one command (idempotent)
cd ~/code/my-app
8sync harness                    # skills + codegraph + AGENTS.md + memory
8sync .                          # open a session (kitty 3-pane + omp)

# 3. Dashboard — view + CRUD the whole agent-team from the browser
8sync harness web                # → http://127.0.0.1:8731

Build from source: git clone … && bash scripts/bootstrap.sh. Common setup flags: --dry-run, --no-profile, --community, --profile <name>.

Dashboard — 8sync harness web

A local web app (axum + Vite/React, embedded in the binary) to view and control the whole agent-team from the browser instead of hand-editing config files. Every page reads real data; most support CRUD written straight to config/memory. Click any screenshot for the full-size PNG.

State page — live plan of the current session
State — the live plan of the current session.
Bench page — token-budget bench with upfront breakdown and spine advisory

Bench — token-budget bench with upfront breakdown (prefix / CORE / memory-spine) + spine advisory.

Codegraph page — package call graph + Leiden clusters

Codegraph — package call graph + Leiden clusters, symbol search, caller/callee tracing — live from codebase-memory-mcp.

Models page — adaptive model routing per role/task

Models — adaptive model routing per role/task, written straight to models.toml.

Marketplace page — MCP + skills marketplace

Marketplace — browse + one-click install MCP servers & skills (official registry, Smithery, Glama, mcp.so).

SessionState (live plan) · Context (real token/compaction)
ConfigureModels · Skills (filter + cycle tier) · Memory (edit 6 files) · Rules (add/remove)
RuntimeEngines · Codegraph graph · MCP · Submodules
QualityBench (live runs) · Readiness · Team
ProjectsWorkspaces (project switcher)
BuildWorkflow (build a pipeline → export as omp extension)
bash 
8sync harness web                # http://127.0.0.1:8731 (auto-opens the browser)
8sync harness web --port 9000    # change the port
8sync harness web --no-open      # background / headless

Core commands

Every verb has -h / --help with an EXAMPLES block. Run 8sync or 8sync help for the cheatsheet.

Vibe loop (daily)

8sync .Open/attach a session (kitty 3-pane + omp --continue inside abduco)
8sync ai [prompt]Empty → resume; with a prompt → one-shot omp -p
8sync find <kw>rg/fd + fzf, opens the editor at file:line
8sync note "msg"Appends to agents/NOTES.md
8sync run dev|build|test|fmt|lintRecipe-based project runner
8sync ship "msg"git add -A && commit && push && gh pr create

Lifecycle & tools

8sync setupInstall the harness + pick profiles
8sync upSelf-update binary + omp update
8sync doctorComprehensive health check
8sync harnessBuild/refresh the harness with one command (idempotent)
8sync harness webLocal dashboard — agent-team CRUD
8sync harness gatewayDeploy/verify omp model-gateway
8sync harness add-local-modelServe a local GGUF model (mistral.rs) as an omp provider
8sync locateVisual grounding — bounding boxes + click points from an image
8sync skillList + add skills (see below)
8sync theme | bgKitty palette / wallpaper live swap
8sync bt | cleanBluetooth / disk cleanup + report
8sync sec on|offWARP VPN + ufw in one go

Skill injection

A skill is an instruction module for the AI. 8sync bundles 35 skills (codegraph · karpathy · ponytail · assp · impeccable · taste · 8sync-cli · image-routing + 18 research skills · …); 8sync skill add is collection-aware and pulls whole sets from GitHub.

bash 
# Clone from a URL: installs into BOTH ~/.omp/skills/ (global, read by omp) and agents/skills/ (project)
# Also rewrites the <!-- 8sync:skills:* --> block in AGENTS.md
8sync skill add https://github.com/colbymchenry/codegraph

# Other spec forms
8sync skill add gh:owner/repo
8sync skill add path:/abs/local/dir
8sync skill add builtin:karpathy

# Idempotent: re-running = git pull --ff-only
8sync skill add https://github.com/colbymchenry/codegraph   # → "updated"

# Build / refresh the whole harness (replaces the old `skill sync`)
8sync harness init
8sync harness up --timer 30m

Update

Two ways:

Auto (recommended)

8sync up

Self-updates the binary (GitHub release) + omp update. Never touches pacman -Syu.

Manual (build from source)

cd su-code && git pull
cargo build --release
install -m755 target/release/8sync \
  ~/.local/bin/8sync

Documentation site

This page is docs/index.html, auto-deployed via GitHub Pages on every push to main.

Sourcedocs/index.html
Workflow.github/workflows/pages.yml
Triggerpush main or workflow_dispatch
URL8-sync-dev.github.io/su-code
Full READMEgithub.com/8-Sync-Dev/su-code#readme
AGENTS.md (for AI)AGENTS.md