Context Manager

Register GitHub repositories and local folders as context sources, check which agent instruction files they contain, and build one combined context text.

packages/context-manager

Context Manager answers “what will an agent read when it opens this repository?” You register sources, and the app shows which context files each one has.

What you do in it

  1. Click + Add Source and choose GitHub Repo (search with gh or pick from your repos), Local Folder (path or Browse…) or Select from Git Projects (the list in ~/.config/robos/git-projects.json, see Git Projects).
  2. Select the source. For a GitHub repo, Clone runs git clone into ~/source/github.com/<org>/<repo>, and Pull runs git pull. The Active switch includes or excludes the source from the combined context. VS Code runs code <folder>, GitHub opens the repo page, Rescan Files re-reads the folder and Remove deletes the source from the list.
  3. Look through the tabs: Context Files, AGENTS.md, Copilot Instructions and Knowledge Graph.
  4. Click View Combined Context to get one text blob (with Copy to Clipboard and a Raw view). For each active source it concatenates up to 4,000 characters from each of the first eight known files that exist: README.md, readme.md, README.rst, AGENTS.md, agents.md, CLAUDE.md, claude.md and .cursorrules.

The scan also looks for ARCHITECTURE.md, CONTRIBUTING.md, CODEOWNERS, docs/README.md, build files (package.json, pom.xml, build.gradle, Cargo.toml, go.mod) and .github/copilot-instructions.md.

AI-assisted drafts

Next to a missing AGENTS.md or .github/copilot-instructions.md, Create with AI Agent drafts one and Save to Repo writes it into the folder. The Knowledge Graph tab has Generate via AI, which asks for a Mermaid diagram built from the README, AGENTS.md, ARCHITECTURE.md and the build file.

These buttons call a robos-copilot-lib module loaded from /usr/local/share/robos/robos-copilot-lib. That module is not in this repository. Without it they report “AI copilot library not available”; the rest of the app works.

Data

  • The source list is ~/.config/robos/context-sources.json. Each source is also written to the SDLC knowledge graph (SDLCKnowledgeGraphStore in packages/robos-graph) as a context source, and sources found there are merged into the list at startup.
  • Generated drafts are logged to ~/.config/robos/journal-events.json.

Requirements

git for clone and pull, the gh CLI for repository search and listing, and VS Code (code) for the editor button. Only one window runs at a time. Source: packages/context-manager.

More in AI & Agent Workflows

Agent Chat A chat window with session history, a model and mode selector and tool cards; replies are currently scripted samples. Agent Sidebar A prototype 320-pixel sidebar that mocks up an agent's plan, tool feed and approve/refine buttons. Agents Manager Browse and continue sessions of Claude Code, GitHub Copilot and Codex, and configure each provider's login, models and MCP servers. AI Prompt Studio Type a task in plain English and run it through the Claude CLI or GitHub Copilot CLI, with optional skills attached as hints. Desktop Agents Viewer A prototype viewer that mocks up watching several agents on their own virtual desktops. MCP Manager Lists the MCP servers registered on this machine, lets you call their tools from a form, and records which agents should have which servers. RobOS Voice Speech-to-text dictation and spoken replies for the desktop, with a local HTTP API on port 19188. Skills Manager Catalog of command snippets and prompt templates for RobOS apps, with custom entries and installable packs from GitHub. Task Implementer Pick a GitHub or Jira task, choose a developer persona, and run the Claude Code CLI on it with streamed output. Task Planner Describe a feature or pick a template, have GitHub Copilot draft epics and tasks, edit them, and create them as issues on your task server.