MCPcopy Index your code
hub / github.com/contextgo/contextgo

github.com/contextgo/contextgo @v1.0.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.0.0 ↗ · + Follow
9,869 symbols 31,066 edges 1,723 files 1,070 documented · 11%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

ContextGo

The next AI-native workbench

A product system that brings frontier models, code agents, project context, connectors, and remote collaboration into one working loop.

中文 · Downloads · Website · Discord Community


What ContextGo Is

ContextGo is not another chat shell, and it is not just a desktop textbox wrapped around model APIs.

It is an AI-native workbench built to solve a harder problem: how to keep agents useful over long-running work inside real projects, without losing control, polluting context, or breaking away from the user's actual workflow.

For end users, ContextGo is a next-generation AGI assistant that can genuinely help get work done.

For developers and teams, it is a full product system that combines project-based work, Agent harnessing, context governance, connectors, remote access, and multi-device surfaces.

In one sentence:

Code agents are not limited to code. With a stable harness, durable context, and real connectors, they can build anything.


The Problem It Solves

Frontier models are already strong, but long-duration agent work still breaks down in familiar ways:

  • the model can reason, but long tasks drift without a stable control system
  • project knowledge, personal preferences, success patterns, and failure patterns do not accumulate cleanly
  • AI remains disconnected from software, documents, IM channels, browsers, and local files
  • cross-device, cross-session, and cross-project usage is still high-friction
  • ordinary users care about one thing: whether the agent can actually do useful work

ContextGo turns those problems into one coherent work system.


Core Concepts

1. Harness Agent

Harness Agent is the narrow qualifier behind the ContextGo view of agents.

The point is not to invent another model. The point is to add a constraint, disclosure, and governance layer around frontier models so long-running human-agent collaboration, or even pure agent execution, can stay ordered instead of becoming chaotic.

That layer is built around a few stable objects:

  • project: work always happens inside a project directory
  • AGENTS.md: the rules entry point and progressive-disclosure root
  • docs/: deeper background, policy, and domain knowledge
  • skills/: executable task-shaped context
  • hooks, commands, and schedules: automation surfaces and shortcut actions

The model handles reasoning and tool use. The harness keeps it controllable inside real work.

2. Agent Group

A single agent can already work for a long time, but not every problem should be solved by one agent in one thread.

ContextGo's Agent Group model is intentionally simple and efficient rather than heavy orchestration:

  • a planner aligns the direction
  • generators keep producing
  • evaluators keep judging
  • multiple agents can research in parallel, cross-check, and race toward better decisions

The goal is not orchestration for its own sake. The goal is higher-quality output from multiple harnessed agents.

3. Context Engine

Context Engine is the stabilizer behind ContextGo.

It is a local-first context engine that continuously organizes, extracts, updates, and governs the high-value signals generated during agent work. It is not just a chat archive, and it is not just traditional vector-only RAG.

It is responsible for:

  • extracting durable preferences, working style, success patterns, and failure patterns
  • reducing entropy and cleaning polluted project context
  • supporting cross-session and cross-project logical spaces through context space
  • refining and compressing context while the user is away, then feeding it back into later work

4. Context Connector And IM Bot Channel

An actually useful agent does not just answer well. It connects into your working context and can publish results back into the collaboration channels you already use.

These are two separate product boundaries:

  • Context Connector brings knowledge sources, documents, browser context, local files, and external product context into ContextGo
  • IM Bot Channel publishes agents into message transports such as Telegram, Slack, Discord, Lark, DingTalk, and WeChat
  • Feishu/Lark should be read as two boundaries: Context Connector > Feishu for context access, and IM Channels > Lark for bot publication

This lets agents consume real context and return results to existing workflows without mixing context connectors and message publication channels into one concept.

5. Host / Client

ContextGo uses a Host Runtime + Client Shell model by default:

  • the Host is the real execution authority for tools, files, browsers, and long-running tasks
  • the Client is the remote access and control surface, whether desktop, browser, or phone

In practice:

  • desktop remains the primary execution host
  • mobile is a natural remote control client
  • remote access reuses the same WebUI / server runtime
  • the Host can live on macOS, Windows, Linux, and eventually cloud machines

What You Can Do With It

  • collaborate with agents inside a real software or knowledge project over time
  • connect documents, browsers, local files, cloud services, and work channels
  • keep agents researching, organizing, producing, and feeding results back
  • start work on desktop and supervise or redirect it from browser or phone
  • build your own assistants, skill bundles, and automation flows
  • make your agents learn you over time instead of restarting from zero every session

The Product Surface

At the product layer, ContextGo turns those ideas into a usable workbench:

ContextGo product overview

Workbench, connectors, built-in agents, context space, scheduling, and remote host

  • built-in agents and Agent Packages
  • composable skills, hooks, commands, and schedules
  • project-level harness bootstrapping
  • multi-device access and remote control
  • publishing and interaction back into IM and operational channels
  • an expanding set of local tools, browser actions, and external integrations

ContextGo publishing and channel loop

Agent publishing and channel feedback loop

It is designed both for developers and for users who do not care about the internals and only want an agent that can actually work.


ContextGo Product Matrix

Repository Role
contextgo Main product and brand repository covering desktop, WebUI, mobile shell, Agent Packages, Context Engine, and the core workbench
connector The connector and controlled-execution boundary for external products, browsers, local resources, and tool operations
skillmarket Skill discovery, mirroring, curation, bundling, and distribution infrastructure
contextgo-releases Public release and distribution endpoint for installers, manifests, updater metadata, and exported public content

Quick Start

As a user

  1. Download the right build from Releases
  2. Launch ContextGo and choose your local Host or remote access path
  3. Start your agent workflow inside a project directory

As a developer

bun install
bun run start

Common development commands:

bun run webui
bun run test
bun run lint:fix
bun run format
bunx tsc --noEmit

Architecture Entry Points

If you want the current product model in more detail, start here:


Open Source Status

ContextGo is advancing three things together:

  • productized agents
  • governed context
  • connected software workflows

That makes it both a usable product and a fast-moving open-source system. Some parts are already stable, some are still evolving, but the direction is consistent:

  • agents should not be limited to chat
  • context should not be reduced to raw history
  • software should be designed for both humans and agents

Community

Extension points exported contracts — how you extend this code

ErrorCommand (Interface)
* 错误命令接口 - 定义错误响应的执行方式 * Error Command Interface - Define how error responses are executed [5 implementers]
src/process/webserver/middleware/errorHandler.ts
VectorIndexProvider (Interface)
(no doc) [4 implementers]
packages/context-engine/src/vectorIndex.ts
IWorkerProcess (Interface)
(no doc) [4 implementers]
src/common/platform/IPlatformServices.ts
SettingsModalProps (Interface)
* 设置弹窗组件属性 / Settings modal component props
src/renderer/components/settings/SettingsModal/index.tsx
Particle (Interface)
(no doc)
apps/web/src/components/ContextParticles.tsx
IStatement (Interface)
(no doc) [6 implementers]
src/process/services/database/drivers/ISqliteDriver.ts
INotificationService (Interface)
(no doc) [4 implementers]
src/common/platform/IPlatformServices.ts
SubModalProps (Interface)
* 二级弹窗组件属性 / Secondary modal component props
src/renderer/components/settings/SettingsModal/index.tsx

Core symbols most depended-on inside this repo

push
called by 1100
src/process/services/context/events/schedule/AssistantScheduleCommandService.ts
get
called by 1076
src/process/utils/configMigration.ts
log
called by 538
src/process/worker/fork/pipe.ts
set
called by 506
src/process/utils/configMigration.ts
on
called by 377
src/common/platform/IPlatformServices.ts
catch
called by 347
src/process/worker/fork/pipe.ts
resolve
called by 309
src/process/services/context/projectContext/ContextExecutionBoundaryResolver.ts
prepare
called by 228
src/process/services/database/drivers/ISqliteDriver.ts

Shape

Function 6,367
Method 2,288
Interface 624
Class 501
Route 54
Enum 23
Struct 12

Languages

TypeScript92%
Python7%
Kotlin1%
Go1%

Modules by API surface

apps/cloud/contextgo_cloud/app.py182 symbols
src/process/services/space/SpaceVaultContextSyncService.ts161 symbols
src/process/services/database/index.ts150 symbols
apps/cloud/tests/test_cloud_api.py77 symbols
src/process/services/cloud/CloudService.ts71 symbols
src/process/resources/assistant/engineering/everything-in-claude-code/skills/continuous-learning-v2/scripts/test_parse_instinct.py63 symbols
mobile-shell/android/app/src/main/java/io/contextgo/mobileshell/MainActivity.kt63 symbols
src/process/channels/types.ts61 symbols
src/process/services/database/types.ts57 symbols
apps/cloud/contextgo_cloud/db.py56 symbols
src/process/agent/acp/index.ts51 symbols
src/process/channels/plugins/dingtalk/DingTalkPlugin.ts50 symbols

Datastores touched

(mysql)Database · 1 repos
app_devDatabase · 1 repos
dbDatabase · 1 repos
dbnameDatabase · 1 repos
mydbDatabase · 1 repos

For agents

$ claude mcp add contextgo \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact