The latest articles on DEV Community by zonal (@mohamed1111111m). https://dev.to/mohamed1111111m https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4180449%2F42dab411-939c-42ba-9c57-f63b8616fee7.png https://dev.to/mohamed1111111m en zonal Mon, 12 Oct 2026 21:41:29 +0000 https://dev.to/mohamed1111111m/i-built-a-local-cli-that-prepares-repository-context-for-ai-coding-tools-7c9 https://dev.to/mohamed1111111m/i-built-a-local-cli-that-prepares-repository-context-for-ai-coding-tools-7c9 <p>Some coding chats can connect to a local folder or GitHub repo. Others cannot, and sometimes I want to hand over only a small, reviewable slice of a project for one task. Collecting those files by hand gets tedious. That is why I built Codebase Brief.</p> <p><a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F04ybvmn2vyfibgxayh1b.png" class="article-body-image-wrapper"><img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F04ybvmn2vyfibgxayh1b.png" alt="Codebase Brief terminal and sample context brief" width="800" height="541"></a></p> <p>Codebase Brief is a local Python CLI. Give it a repository and a task; it suggests files and explains why, then builds a compact Markdown handoff with excerpts and paths. You can keep, remove, or add suggestions. An optional Git base ref prioritizes changed files and supported direct importers.</p> <p>It makes no AI calls and does not upload repository contents. File selection is heuristic: it can miss useful files or include irrelevant ones. Review the suggestions and the brief before sharing. If your assistant already reads your current working tree and that access suits you, its built-in tools may be simpler. Codebase Brief is for chats without that access, or when you want a smaller, explicit handoff. The <a href="https://github.com/mohamed1111111m/codebase-brief#when-codebase-brief-fits" rel="noopener noreferrer">README explains when it fits</a>.</p> <p>To preview it with a temporary sample project:<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>pipx <span class="nb">install </span>codebase-brief brief <span class="nt">--demo</span> </code></pre> </div> <p>To make a brief for your own task:<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>brief <span class="s2">"/path/to/your/repo"</span> <span class="nt">--task</span> <span class="s2">"Trace the login flow"</span> <span class="nt">--copy</span> </code></pre> </div> <p>Replace the example path and task with yours. If you want Git changes prioritized, add --base main only when main is the right base ref for your repo. The brief is copied to your clipboard; paste it into your chat and check it before sharing. If you already installed it, use pipx upgrade codebase-brief.</p> <p>I would like feedback from developers who try it on a repository they know: Which suggested files did you remove? Which useful ones did you add? Did the brief give your assistant enough to get started? The CLI prints a summary of those changes. You can share it through the <a href="https://github.com/mohamed1111111m/codebase-brief/issues/new?template=tester-feedback.yml" rel="noopener noreferrer">tester feedback form</a>—please remove private paths or details first.</p> <p>I made Codebase Brief. The <a href="https://github.com/mohamed1111111m/codebase-brief" rel="noopener noreferrer">source, screenshots, and full instructions are on GitHub</a>.</p> showdev python opensource ai