Skip to content

GITHUB_PUBLICATION.md

Latest commit

 

History

History
98 lines (70 loc) · 2.44 KB

GITHUB_PUBLICATION.md

File metadata and controls

98 lines (70 loc) · 2.44 KB
Raw

GitHub Publication

Repository name

Recommended:

codebase-skill

If you want the name to emphasize the CLI more than the skill:

codebase-cli-skill

About

Short description

CLI-first local wrapper for codebase-memory-mcp with optional Codex skill integration.

Longer About text

Repository-local code indexing and graph retrieval for agent workflows. Uses codebase-memory-mcp as the engine, stores indexes under .codebase/, and avoids MCP protocol overhead at runtime.

Topics

Recommended GitHub topics:

agent-tools
developer-tools
python-cli
code-search
code-indexing
codebase-memory-mcp
codex
claude-code
copilot

Social preview text

Local code indexing for agent workflows: repository-scoped, CLI-first, MCP-free at runtime.

Pinned feature bullets

Useful for the top of the README, repository sidebar copy, or launch post:

  • repository-local index storage under .codebase/
  • codebase shell command for search, call graph traversal, snippets, and refresh
  • optional codebase skill install for Codex, direct CLI use for Claude Code, OpenCode, and Copilot
  • built on DeusData/codebase-memory-mcp, without requiring MCP at runtime
  • macOS and Ubuntu 24 friendly install path

First release

Title

v0.4.0: initial public release

Body

codebase-skill is a CLI-first local wrapper around codebase-memory-mcp with optional Codex skill integration.

Highlights:
- repository-local index storage under .codebase/
- global codebase command with refresh, function lookup, call graph traversal, snippets, and code search
- optional ~/.codex/skills/codebase installation for Codex users, direct CLI use for other agent tools
- macOS and Ubuntu 24 friendly installation
- no MCP protocol required at runtime

Why this exists:
- reduce runtime overhead compared with MCP-first retrieval flows
- keep repo instructions simple across Codex, Claude Code, OpenCode, and Copilot
- preserve project-local indexing behavior instead of pushing state into external services

Validation:
- smoke tests pass
- package builds as sdist and wheel
- installer verified in a clean temporary HOME

Suggested launch blurb

Open-sourced a small but pragmatic tool: codebase-skill. It wraps codebase-memory-mcp behind a local codebase CLI and an optional Codex skill, keeps indexes in .codebase/, and avoids MCP protocol overhead during normal repository retrieval.