Skip to content

index.md

Latest commit

 

History

History
70 lines (52 loc) · 3.69 KB

index.md

File metadata and controls

70 lines (52 loc) · 3.69 KB
Raw

Synerise base-context documentation

Base Context is a coding and research agent built around a persistent Python workspace, recursive agents, and source-backed context management. It is an MIT-licensed fork of Prime Agent by Synerise.

Quick start

With Node.js ^22.12.0 || >=23.3.0, npm, and uv:

npm install -g @ponythewhite/base-context
cd /path/to/project
base-context

Use /login to configure an authorized provider, then /model to choose a model. See quickstart for the first session and installation for source builds, Python setup, updates, and rollback.

Read why we forked Prime Agent and how context management works for the design and its limits.

Start Here

  • Quickstart - install, authenticate, and run a first session.
  • Using Base Context - interactive mode, RLM subagents, slash commands, context files, and CLI reference.
  • Architecture overview - client, daemon, worker, session, kernel, provider, and storage boundaries.
  • RLM programming model - programmatic execution, native subagents, Python skills, and durable state.
  • Long-running and background agents - daemon workers, messaging, heartbeats, goals, schedules, and autonomous mode.
  • Providers - subscription and API-key setup for built-in providers.
  • Settings - global and project settings.
  • Keybindings - default shortcuts and custom keybindings.
  • Sessions - session management, branching, and tree navigation.
  • Compaction - context compaction and branch summarization.

Customization

  • Extensions - TypeScript modules for tools, commands, events, and custom UI.
  • Skills - markdown and Python-backed skills, including how to ask Base Context to create them.
  • MCP integrations - use MCP servers through Python skills without expanding the model's tool surface.
  • Prompt templates - reusable prompts that expand from slash commands.
  • Themes - built-in and custom terminal themes.
  • Base Context packages - bundle and share extensions, skills, prompts, and themes.
  • Custom models - add model entries for supported provider APIs.
  • Custom providers - implement custom APIs and OAuth flows.

Programmatic Usage

  • SDK - embed Base Context in Node.js applications.
  • ACP mode - drive Base Context from any Agent Client Protocol client.
  • RPC mode - integrate over stdin/stdout JSONL.
  • JSON event stream mode - print mode with structured events.
  • TUI components - build custom terminal UI for extensions.

Reference

Platform Setup

Development