Eli Finer contributor

Finereli

Give coding agents architectural memory from git history so they read why the codebase evolved before changing files.

Overview

code-aware is a plugin marketplace for the Build phase that scans git history and produces agent-readable architectural notes before you edit the codebase.

What is this marketplace?

  • Processes git history into developer-notes-style markdown, not just file trees
  • Outputs readable context any Agent Skills–compatible client can load before changes
  • Claude Code marketplace install: `/plugin marketplace add finereli/code-aware`
  • Manual `scan.sh` quick scan when you want a local LLM pass over the project
  • Works with Claude Code, Codex, Copilot, and Cursor via skill discovery
  • Marketplace lists 1 plugin (code-aware)
  • Supports Agent Skills standard clients including Claude Code, Codex, Copilot, and Cursor

Compatible agents: Claude Code, Cursor, Codex, any compatible agent

Community signal: 1 GitHub stars.

What problem does it solve?

Agents and returning builders lack narrative context about why code was written, so changes repeat mistakes or fight legacy decisions.

Who is it for?

Solo devs or small teams on mature repos who delegate refactors to Claude Code, Cursor, or Codex and need cheap, refreshable context.

Skip if: Greenfield repos with almost no git history or teams that only want static README docs without automated history synthesis.

What do I get? / Deliverables

After install and a scan, agents read markdown developer notes grounded in evolution history and make changes with a shared mental model of the repo.

  • Markdown developer-notes files describing structure and evolution
  • Installed code-aware skill discoverable across projects (marketplace path)
  • Repeatable scan workflow via agent prompt or scan.sh

Plugins in this marketplace

1 plugin — install individually after you add the marketplace.

Recommended Marketplaces

Journey fit

Build is the canonical shelf because the payoff is safer implementation and refactors with context, not pre-build validation or post-launch growth tooling. agent-tooling matches a skill that augments how agents load repo-specific narrative before edits, distinct from writing app frontend code directly.

How it compares

Agent memory skill from git narrative, not a Ship-phase security scanner or a Launch SEO marketplace.

Common Questions / FAQ

Who is code-aware for?

Builders using Claude Code, Cursor, Codex, or Copilot who need agents to understand architectural intent before modifying an existing codebase.

When should I use code-aware?

Run it before large refactors, unfamiliar feature areas, or whenever an agent session starts cold on a repo with meaningful commit history.

How do I add code-aware to my agent?

In Claude Code: `/plugin marketplace add Finereli/code-aware` then `/plugin install code-aware@Finereli`, or clone the repo, `npm install`, and link `skills/code-aware` into your agent skills directory.

This week for builders

Five minutes, every Monday — the tools, releases and tactics for shipping solo.

unsubscribe anytime.