Skip to content

v0.1.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 13 Sep 19:41
· 1 commit to main since this release
v0.1.0
b5837e0

repomap v0.1.0 — initial release

A CLI with two jobs:

repomap map

Generates a Markdown or plain-text map of a repository: directory tree, language breakdown, file/directory counts.

repomap agents

Scaffolds instruction/skill files for AI coding agents (Claude Code, GitHub Copilot, Cursor, and the generic AGENTS.md convention), derived from the repository's own structure — aimed at cutting the tokens a fresh agent session burns re-deriving context, and the turns lost to permission prompts for routine commands.

What gets detected and generated:

  • Languages & build ecosystems — Go, Node.js, Python (pip/Poetry), Rust, Java (Maven/Gradle), Ruby, PHP, C/C++ (CMake), Dart/Flutter, Elixir, Swift, and Deno, each with build/test/lint commands.
  • Node.js package manager — detected from the lockfile (npm/yarn/pnpm/bun), so commands are correct instead of always assuming npm.
  • Entry points — main.go, index.ts, manage.py, Program.cs, etc., so an agent knows where to start reading.
  • CI configuration — GitHub Actions (with workflow names), GitLab CI, CircleCI, Travis, Jenkins, Azure Pipelines, Bitbucket Pipelines.
  • Key frameworks/dependencies — React, Next.js, Vue, Angular, Django, Flask, FastAPI, Gin, Echo, Fiber, Actix, Axum, Rails, and more, detected from manifest content.
  • Environment templates — .env.example / .env.sample / .env.dist, noted so an agent copies and fills it in instead of guessing required configuration.
  • Monorepo sub-projects — nested manifests like apps/web/package.json or services/api/go.mod, so an agent doesn't spend a turn on find.
  • Style/lint config — .editorconfig, .eslintrc*, .golangci.yml, rustfmt.toml, etc., so an agent follows existing conventions instead of re-deriving them.
  • .claude/settings.json permissions — a pre-populated allowlist (ecosystem build/test/lint commands, plus git status/diff/log/show/blame/add, find, ls, grep, rg, wc) so Claude Code doesn't prompt for routine commands, while destructive git operations (push --force, reset --hard, clean -f, rm -rf, …) stay explicitly denied.

Generated targets:

  • CLAUDE.md + .claude/skills/<project>-overview/SKILL.md + .claude/settings.json for Claude Code
  • .github/copilot-instructions.md for GitHub Copilot
  • .cursor/rules/repository.mdc for Cursor
  • AGENTS.md, the generic convention read by several agentic coding tools

Ships as cross-platform binaries for linux/darwin/windows (amd64/arm64) below.

Commits in this release

  • Detect CI, frameworks, entry points, package managers, and monorepo layout for agent scaffolding
  • Detect Dart/Flutter, Elixir, Swift, and Deno ecosystems
  • Generate .claude/settings.json permissions from detected ecosystems
  • Replace go-gitignore dependency with a native implementation
  • Initial repomap CLI: repository maps and AI agent scaffolding
Assets 9
Loading