Terminal-native agent for real codebases

A coding agent that learns your project before it changes it.

Topchester is a TUI coding agent tightly coupled to a committed project knowledge base. It compiles what your repo contains, checks for drift, retrieves project context while it works, and keeps knowledge current after meaningful changes.

$ npm install -g topchester-ai
$ cd your-project
$ topchester kb init
$ topchester kb compile
$ topchester

Install

Install Topchester from npm.

Use the npm package to install the terminal-native agent globally and start working in your project directory.

npm
npm install -g topchester-ai

Project knowledge first

Topchester compiles a repo-local topchester-kb/ so the agent works from a structured understanding of files, modules, features, and relationships.

Drift-aware workflow

It warns when project knowledge is stale and refreshes changed knowledge after implementation work instead of relying on old context.

Terminal-native TUI

Chat, inspect tool output, review diffs, resume sessions, and keep working from the terminal without switching into a heavyweight IDE workflow.

Workflow

Compile knowledge, then code with context.

  1. Run Topchester in a project directory.
  2. Initialize and compile the project knowledge base.
  3. Ask the agent to plan, edit, test, and keep the KB fresh.