{"id":48255685,"url":"https://github.com/andrewchambers/minicoder","last_synced_at":"2026-04-04T21:11:38.792Z","repository":{"id":305659109,"uuid":"1023510026","full_name":"andrewchambers/minicoder","owner":"andrewchambers","description":"A minimalist AI terminal agent and assistant for unix systems","archived":false,"fork":false,"pushed_at":"2025-08-06T23:20:51.000Z","size":2160,"stargazers_count":8,"open_issues_count":5,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-11-30T03:45:55.843Z","etag":null,"topics":["agent","ai","cli"],"latest_commit_sha":null,"homepage":"https://andrewchambers.github.io/minicoder/","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andrewchambers.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"support/build-with-cosmo.sh","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["andrewchambers"]}},"created_at":"2025-07-21T09:13:17.000Z","updated_at":"2025-11-05T20:25:45.000Z","dependencies_parsed_at":"2025-07-23T07:11:06.404Z","dependency_job_id":null,"html_url":"https://github.com/andrewchambers/minicoder","commit_stats":null,"previous_names":["andrewchambers/assist","andrewchambers/minicoder"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/andrewchambers/minicoder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrewchambers%2Fminicoder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrewchambers%2Fminicoder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrewchambers%2Fminicoder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrewchambers%2Fminicoder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andrewchambers","download_url":"https://codeload.github.com/andrewchambers/minicoder/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrewchambers%2Fminicoder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31414397,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T20:09:54.854Z","status":"ssl_error","status_checked_at":"2026-04-04T20:09:44.350Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["agent","ai","cli"],"created_at":"2026-04-04T21:11:38.250Z","updated_at":"2026-04-04T21:11:38.785Z","avatar_url":"https://github.com/andrewchambers.png","language":"C","funding_links":["https://github.com/sponsors/andrewchambers"],"categories":[],"sub_categories":[],"readme":"# minicoder\n\n**Website**: [https://andrewchambers.github.io/minicoder/](https://andrewchambers.github.io/minicoder/)\n\n**Downloads**: [itch.io/minicoder](https://andrewchambers.itch.io/minicoder)\n\n**Discord**: [Join our community](https://discord.gg/cZk3yxBxRS)\n\n**⚠️ Alpha version** - Be an early tester and supporter!\n\n`minicoder` is a command line tool that uses ai to assist the user at\nany task you can do from the command line on unix systems.\n\n![minicoder demo](https://github.com/andrewchambers/minicoder/blob/artifacts/minicoder-demo.gif?raw=true)\n\nIt is designed around a few core ideas: \n\n- Follow good cli and unix design practices.\n- Keep the tool as simple as possible, relying on AI advances to improve.\n\n## Examples\n\n```\n$ minicoder --files '*.c' 'Can you fix the compile errors in this project?'\n```\n\n```\n$ minicoder --model openai/o3 'Can you explain the files in the current directory?'\n```\n\n## Support the Project\n\nminicoder is free and open source software. You can build it yourself from source, or download pre-built statically linked binaries from [itch.io](https://andrewchambers.itch.io/minicoder) with pay-what-you-like pricing.\n\nYour support helps maintain and improve this tool for everyone.\n\n## Community\n\nJoin our Discord community to get help, share ideas, and discuss minicoder development:\n\n**Discord**: [Join the minicoder Discord](https://discord.gg/cZk3yxBxRS)\n\n## Quick Start\n\n```bash\n# Set up your API key (OpenRouter or OpenAI)\nexport OPENROUTER_API_KEY=\"your-key\"  # or OPENAI_API_KEY\n\n# Basic usage\nminicoder \"Fix the bug in main.c\"\n\n# Choose a specific model\nminicoder --model deepseek \"Optimize this function\"\n\n# Include specific files\nminicoder --files 'src/*.js tests/*.js' \"Add unit tests\"\n```\n\n## User manuals\n\n- [minicoder(1)](https://andrewchambers.github.io/minicoder/minicoder.1.html) - Main manual page\n- [minicoder-model-config(5)](https://andrewchambers.github.io/minicoder/minicoder-model-config.5.html) - Model configuration documentation\n\n### Use your own AI models\n\nSee [minicoder-model-config(5)](https://andrewchambers.github.io/minicoder/minicoder-model-config.5.html) for details on configuring custom models.\n\n### Sandboxing\n\nSandboxing is a work in progress.\nWe aim to provide a simplified interface to limit\nthe assistant to specific directories and alsto to disable internet access. \n\n## Building\n\n### Prerequisites\n\n- C compiler (gcc, clang, etc.)\n- libcurl with development headers\n- Standard POSIX build tools (make)\n\n### Build from source\n\n```bash\ngit clone https://github.com/andrewchambers/minicoder.git\ncd minicoder\nmake\nsudo make install PREFIX=/usr/local\n```\n\nThe build process is straightforward - just run `make`. The Makefile will compile minicoder with your system's libcurl. \n\n## Design notes\n\n### Coding conventions\n\n- The software is written in C to keep it resource light and portable.\n- We use a tiny conservative garbage collector to prevent many of C's pitfalls.\n- This project is often developed with AI assistance.\n\n### Agent loop\n\n- We try to make the agent loop is as simple as possible.\n- The model is asked to keep track of its own plans and todos across iterations.\n- The model is asked to 'focus' on files as it sees fit (add/remove from the context).\n- The model performs actions in the world by generating shell scripts which are run, the output of which is returned to the model.\n- There is no model/provider specific tool call convention.\n- There is no infitely growing context, instead the model is fed its own compacted summary each iteration.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrewchambers%2Fminicoder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandrewchambers%2Fminicoder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrewchambers%2Fminicoder/lists"}