codeview

name	codeview
description	Manage reference codebases with the codeview CLI. Use when the user asks to add, list, clone, or update reference repos in a project's resources/ folder, mentions "codeview", or when you need a reference codebase (templates, patterns, examples) available locally to implement code against.

codeview CLI

codeview keeps a registry of frequently-used reference repositories and clones them into a project's resources/ folder so coding agents can read them for patterns, templates, and examples.

• Registry: ~/.config/codeview/repos.json (name, url, description)
• Global cache: ~/.cache/codeview — repos fetched < 1 week ago are reused with no network
• Runtime: Bun. If codeview is not on PATH, run bun src/index.ts from the codeview repo or bun link it.

Commands (all headless unless noted)

codeview add <git-url> [--name <name>] [--desc "what it does"]  # register a repo
codeview describe <name> "<description>"                        # set/update description
codeview remove <name>                                          # unregister
codeview list                                                   # show repos, cache freshness, installed (*)
codeview setup <name...>                                        # clone specific repos into ./resources
codeview setup --all                                            # clone every registered repo
codeview setup --force                                          # bypass 1-week cache, refetch
codeview setup                                                  # INTERACTIVE fuzzy picker (avoid as an agent)
codeview update                                                 # cleanly refresh repos already managed in ./resources
codeview help

Agent workflow

1. codeview list to see what's registered and installed.
2. As an agent, ALWAYS pass repo names or --all to setup — never run bare codeview setup (it opens a TUI).
3. When adding repos, always include --desc so agents know what each repo is for.
4. setup automatically:
   • Copies repos into ./resources/<name> (no .git)
   • Adds resources/ to .gitignore
   • Records Codeview-owned directories in resources/.codeview-manifest.json
   • Appends/updates a marker-delimited section in BOTH AGENTS.md and CLAUDE.md (creating them if missing) listing the repos and their descriptions

Notes

• resources/ contents are read-only references — never edit them or commit them.
• Codeview refuses to replace a resource directory that is not recorded in its project manifest.
• The AGENTS.md section is idempotent (managed between <!-- codeview:start --> / <!-- codeview:end --> markers); safe to re-run.
• update always hits the network and replaces each managed repo from a clean clone; setup reuses the global cache when fresh (< 1 week).