{"id":31727628,"url":"https://github.com/thiswillbeyourgithub/aiderbuilder","last_synced_at":"2025-10-09T06:29:28.293Z","repository":{"id":313493246,"uuid":"1051291662","full_name":"thiswillbeyourgithub/AiderBuilder","owner":"thiswillbeyourgithub","description":"Automate aider chat operations seamlessly with AiderBuilder's loop-running script guide included.","archived":false,"fork":false,"pushed_at":"2025-10-05T17:02:23.000Z","size":12,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-05T18:39:25.123Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thiswillbeyourgithub.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-05T18:35:32.000Z","updated_at":"2025-10-05T17:02:26.000Z","dependencies_parsed_at":"2025-09-06T13:18:21.526Z","dependency_job_id":"3a713562-bed6-4a1a-bbf9-7a13892dc7c0","html_url":"https://github.com/thiswillbeyourgithub/AiderBuilder","commit_stats":null,"previous_names":["thiswillbeyourgithub/aiderbuilder"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/thiswillbeyourgithub/AiderBuilder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thiswillbeyourgithub%2FAiderBuilder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thiswillbeyourgithub%2FAiderBuilder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thiswillbeyourgithub%2FAiderBuilder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thiswillbeyourgithub%2FAiderBuilder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thiswillbeyourgithub","download_url":"https://codeload.github.com/thiswillbeyourgithub/AiderBuilder/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thiswillbeyourgithub%2FAiderBuilder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000825,"owners_count":26082950,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-09T06:29:24.668Z","updated_at":"2025-10-09T06:29:28.287Z","avatar_url":"https://github.com/thiswillbeyourgithub.png","language":"Shell","readme":"# AiderBuilder\n\nA simple, self-contained, zsh script implementing a generalist, recursive, LLM agent using [aider.chat](https://github.com/Aider-AI/aider/).\n\nIt was created for situations where I have written extensive specifications for a project and don't want to spend my attention to split the specs into a plan for an LLM.\n\nExamples of successful usage include:\n- turning a survey into a full fledged gradio app with specific requirements.\n- recording audio for a while then using that transcript as specification to create a PDF using *LaTeX*.\n\nAiderBuilder itself was built with the help of [aider.chat](https://github.com/Aider-AI/aider/).\n\n## What It Does\n\nRuns aider in a loop with builder rules that maintain a `ROADMAP.md` file to coordinate incremental development across iterations. Aider creates `FINISHED.md` when complete.\n\n## Requirements\n\n- `zsh` shell\n- [aider](https://github.com/Aider-AI/aider) in PATH\n\n## Installation\n\n```bash\nchmod +x aider_builder\n```\n\n## Usage\n\n```bash\n./aider_builder -n_iter N -s \"what to build\" [AIDER_ARGS...]\n```\n\n### Required Arguments\n\n- `-n_iter N`: Iterations per batch (must be \u003e 1)\n- `-s, --specifications SPEC`: What to build (passed as prompt to aider). Can be a direct string or a path to a file containing the specifications.\n\n### Optional Arguments\n\n- `-h, --help`: Show help\n- `-v, --version`: Show version\n- `AIDER_ARGS...`: Additional aider arguments (don't use `--message`, use `-s` instead)\n\n### Examples\n\n```bash\n# Build a CLI tool with inline specification\n./aider_builder -n_iter 5 -s \"Create a Python CLI calculator using click\"\n\n# Build from a specification file\n./aider_builder -n_iter 10 -s specs.txt\n\n# With architect mode\n./aider_builder -n_iter 10 -s \"Build a REST API with FastAPI\" --architect\n```\n\n## How It Works\n\n1. Checks no `FINISHED.md` exists from previous builds\n2. Loads builder rules into aider\n3. Runs `n_iter` iterations where aider:\n   - Creates/updates `ROADMAP.md` to track progress\n   - Performs one development step at a time\n   - Records decisions and issues in `ROADMAP.md`\n4. Prompts to continue after each batch\n5. Stops when aider creates `FINISHED.md`\n\n## Builder Rules\n\nAider is instructed to:\n- Use `ROADMAP.md` for coordination with TODO checkboxes\n- Work incrementally, one step at a time\n- Record design decisions and errors\n- Estimate progress at each iteration\n- Create `FINISHED.md` when done\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthiswillbeyourgithub%2Faiderbuilder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthiswillbeyourgithub%2Faiderbuilder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthiswillbeyourgithub%2Faiderbuilder/lists"}