{"id":50670279,"url":"https://github.com/kogeletey/milka","last_synced_at":"2026-06-08T10:33:29.025Z","repository":{"id":325766247,"uuid":"1069765134","full_name":"kogeletey/milka","owner":"kogeletey","description":"One command, multiple git repositories","archived":false,"fork":false,"pushed_at":"2026-02-14T12:56:04.000Z","size":122,"stargazers_count":5,"open_issues_count":2,"forks_count":1,"subscribers_count":0,"default_branch":"release","last_synced_at":"2026-02-14T21:39:46.665Z","etag":null,"topics":["cli","crystal"],"latest_commit_sha":null,"homepage":"","language":"Crystal","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/kogeletey.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-10-04T15:24:00.000Z","updated_at":"2026-02-14T12:56:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kogeletey/milka","commit_stats":null,"previous_names":["kogeletey/mise-milka"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/kogeletey/milka","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kogeletey%2Fmilka","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kogeletey%2Fmilka/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kogeletey%2Fmilka/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kogeletey%2Fmilka/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kogeletey","download_url":"https://codeload.github.com/kogeletey/milka/tar.gz/refs/heads/release","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kogeletey%2Fmilka/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34059156,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-08T02:00:07.615Z","response_time":111,"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":["cli","crystal"],"created_at":"2026-06-08T10:33:23.489Z","updated_at":"2026-06-08T10:33:29.018Z","avatar_url":"https://github.com/kogeletey.png","language":"Crystal","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Milka\n\nA command-line tool for managing multiple git repositories simultaneously. Milka allows you to clone, fetch, pull, and push changes across multiple repositories with a single command, making it easy to manage projects with multiple related repositories.\n\n## TL;DR\n\nQuick start with Milka:\n\n1. **Install**: Download from [Releases](https://github.com/kogeletey/milka/releases) or build from source\n2. **Configure**: Create `.meta/reps.toml` with your repositories\n3. **Use**: Run commands like `milka clone`, `milka pull`, `milka push` to manage all repos at once\n\nExample config:\n```toml\n[[repo]]\ndir = 'my-project'\nremote = 'https://github.com/username/my-project.git'\nbranch = 'main'\n\n[[repo]]\ndir = 'my-submodule'\nremote = 'https://github.com/username/submodule.git'\nbranch = 'main'\nsource = 'git+subtree'  # For subtree operations (new feature!)\n```\n\n**New Feature: Subtree Support** - Use the `--subtree` flag to work only with repositories that have `source = \"git+subtree\"` in your configuration!\n\n## 🚀 Version 2025.11.8 Highlights (Latest Release)\n\n- **Plugin architecture for github command**: The `github` command is now an optional plugin that can be built separately with `shards build milka-github -Dgithub_plugin`\n- **Leaner default build**: The default `milka` binary no longer includes the GitHub scanning functionality, keeping it lightweight\n- **Easy plugin installation**: Users who need GitHub org/user scanning can build the extended version with a single command\n\n## 🚀 Version 2025.11.7 Highlights\n\n- **New `github` command** (plugin): Scan and clone all repositories from a GitHub organization or user with `milka github \u003corg-name\u003e`\n- **Optional cloning**: Use `milka github \u003corg-name\u003e --clone` to both add repos to config and clone them\n- **GitHub API integration**: Automatic pagination for organizations with many repositories\n- **Token authentication**: Support for `GITHUB_TOKEN` and `GH_TOKEN` environment variables for private repos and higher rate limits\n\n## 🚀 Version 2025.11.6 Highlights\n\n- **Enhanced error handling**: Improved error messages and handling for repository operations\n- **Performance improvements**: Faster repository scanning and operations with large numbers of repositories\n- **Configuration validation**: Automatic validation of `.meta/reps.toml` configuration file format\n- **Improved logging**: More detailed logging and progress information during operations\n\n## 🚀 Version 2025.11.5 Highlights\n\n- **New `create` command**: Replace `init` with `milka create \u003crepo-name\u003e` to create new git repositories\n- **Subtree repository creation**: Use `milka create \u003cdir\u003e --subtree` to set up subtree repositories in existing directories\n- **Git initialization for non-git directories**: Enhanced scan functionality automatically initializes git when using `--subtree` flag\n\n\n## Table of Contents\n- [Features](#features)\n- [Installation](#installation)\n- [Quick Start](#quick-start)\n- [Configuration](#configuration)\n- [Commands](#commands)\n- [Usage Examples](#usage-examples)\n- [Author](#author)\n- [License](#license)\n\n## Features\n\n- **Clone multiple repositories** at once using a configuration file\n- **Fetch updates** from multiple repositories simultaneously\n- **Pull latest changes** from all configured repositories\n- **Push changes** to multiple repositories at once\n- **Subtree support** - Use git subtree operations with `--subtree` flag\n- **Scan** current directory for existing git repositories and add them to configuration\n- **GitHub organization scanning** (plugin) - Fetch and clone all repositories from a GitHub organization or user (requires `-Dgithub_plugin` build flag)\n- **Colored output** for better readability\n- **Spinner indicators** for ongoing operations\n- **Authentication support** for private repositories using personal access tokens\n\n## Installation\n\n### From Source\n\n1. Ensure you have [Crystal](https://crystal-lang.org/) installed (version \u003e= 1.0.0)\n2. Clone this repository\n3. Build the project:\n   ```bash\n   # Standard build (without github command)\n   shards build\n\n   # Build with GitHub plugin (includes the github command)\n   shards build milka-github -Dgithub_plugin\n   ```\n4. The executable will be available as `bin/milka` (or `bin/milka-github` for the plugin version)\n\n### Pre-built Binaries\n\nPre-built static binaries are available for download on the [Releases](https://github.com/kogeletey/milka/releases) page. These are statically linked and can run on most systems without additional dependencies.\n\n1. Download the appropriate binary for your platform\n2. Extract the archive\n3. Make the binary executable (on Unix-like systems): `chmod +x milka`\n4. Optionally, move the binary to a directory in your PATH\n\n## Building with Container static build\n\nYou can also build Milka using the provided container configuration. See `.meta/packaging/static-builds/Containerfile` for the container build setup.\n\n### Docker\n```bash\n# Build the container\ndocker build -f .meta/packaging/static-builds/Containerfile -t milka .\n\n# Run commands in the container\ndocker run --rm -v $(pwd):/workspace -w /workspace milka clone\ndocker run --rm -v $(pwd):/workspace -w /workspace milka pull\n\n# Copy the static binary from the built container\ndocker create --name milka-container milka\ndocker cp milka-container:/usr/local/bin/milka ./milka\ndocker rm -v milka-container\n```\n\nContainer builds provide a reproducible build environment and make it easy to run Milka in containerized environments.\n\n## Quick Start\n\n1. Create a `.meta/reps.toml` configuration file in your project root with the repositories you want to manage:\n\n    ```toml\n    [[repo]]\n    dir = 'my-project'\n    remote = 'https://github.com/username/my-project.git'\n    branch = 'main'\n\n    [[repo]]\n    dir = 'my-other-project'\n    remote = 'https://github.com/username/my-other-project.git'\n    branch = 'develop'\n    ```\n\n2. Clone all repositories at once:\n   ```bash\n   ./bin/milka clone\n   ```\n\n3. Pull latest changes from all repositories:\n   ```bash\n   ./bin/milka pull\n   ```\n\n## Configuration\n\nMilka uses a TOML file (default: `.meta/reps.toml`) to define which repositories to manage.\n\n### Configuration File Format\n\nThe configuration file uses the following format:\n\n```toml\n[[repo]]\ndir = 'directory-name'           # Local directory name where the repo will be cloned\nremote = 'https://github.com/username/repo.git'  # Git repository URL\nbranch = 'main'                  # Branch to work with (default: 'main')\n# commit = ''                    # Specific commit to checkout (optional)\n```\n\n### Default Configuration Location\n\nBy default, Milka looks for configuration in `.meta/reps.toml` relative to the current working directory. You can specify a different location using the `--config` option.\n\n## Commands\n\n### `clone`\nClone repositories specified in the configuration file.\n\n```bash\nmilka clone                    # Clone all repositories\nmilka clone repo-name          # Clone specific repository\nmilka clone --subtree          # Clone only repositories with source = \"git+subtree\" (new!)\n```\n\n### `fetch`\nFetch updates from remote repositories without merging.\n\n```bash\nmilka fetch                    # Fetch all repositories\nmilka fetch repo-name          # Fetch specific repository\nmilka fetch --subtree          # Fetch only repositories with source = \"git+subtree\" (new!)\n```\n\n### `pull`\nPull latest changes from remote repositories.\n\n```bash\nmilka pull                     # Pull all repositories\nmilka pull repo-name           # Pull specific repository\nmilka pull --subtree           # Pull only repositories with source = \"git+subtree\" (new!)\n```\n\n### `push`\nPush local changes to remote repositories.\n\n```bash\nmilka push                     # Push all repositories\nmilka push repo-name           # Push specific repository\nmilka push --subtree           # Push only repositories with source = \"git+subtree\" (new!)\n```\n\n### `init`\nInitialize a new configuration file for managing repositories.\n\n```bash\nmilka init                     # Create a new .meta/reps.toml configuration file with template\n```\n\n### `scan`\nScan current directory for git repositories and add them to the configuration file.\n\n```bash\nmilka scan                     # Scan and add git repos to config (with source = \"git\")\nmilka scan --subtree           # Scan and add git repos to config (with source = \"git+subtree\")\n```\n\n### `github` (Plugin)\nScan GitHub organization or user repositories and add them to the configuration file. Optionally clone them as well.\n\n**Note**: This command is only available in the `milka-github` binary built with `-Dgithub_plugin` flag.\n\n```bash\nmilka-github github myorg             # Scan GitHub org 'myorg' and add all repos to config\nmilka-github github myorg --clone     # Scan and also clone all repositories\nmilka-github github myuser --subtree  # Scan user 'myuser' and add repos with subtree source\n```\n\n**Authentication**: For private repositories or to avoid rate limits, set the `GITHUB_TOKEN` or `GH_TOKEN` environment variable with your GitHub personal access token.\n\n### `help`\nShow usage information.\n\n```bash\nmilka help                     # Show help message\n```\n\n## Options\n\n- `--config \u003cpath\u003e`: Specify custom path to configuration file (default: `./.meta/reps.toml`)\n- `--branch \u003cbranch\u003e`: Override branch for operations (default: branch from config or 'main')\n- `--subtree`: With scan: Add repositories with `source = \"git+subtree\"` (default: \"git\")\n\n## Usage Examples\n\nClone all configured repositories:\n```bash\nmilka clone\n```\n\nClone a specific repository:\n```bash\nmilka clone my-repo\n```\n\nPull changes from all repositories:\n```bash\nmilka pull\n```\n\nFetch updates for a specific repository:\n```bash\nmilka fetch my-repo\n```\n\nPush changes to all repositories:\n```bash\nmilka push\n```\n\nPull changes from all repositories using a specific branch:\n```bash\nmilka --branch develop pull\n```\n\nUse a custom configuration file:\n```bash\nmilka --config /path/to/custom.toml pull\n```\n\nScan current directory and add git repositories to configuration:\n```bash\nmilka scan                     # Add repos plane, not git init\nmilka scan --subtree           # Add repos with subtree functionality\n```\n\nScan and clone all repositories from a GitHub organization (requires plugin build):\n```bash\n# Build the plugin version first: shards build milka-github -Dgithub_plugin\nmilka-github github myorg             # Add all org repos to config\nmilka-github github myorg --clone     # Add to config and clone all repos\nGITHUB_TOKEN=your_token milka-github github private-org --clone  # With authentication\n```\n\n## Author\n\nMilka is developed by Konrad Geletey \u003ckg@re128.org\u003e.\n\n## License\n\nThis project is licensed under the ISC License. See the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkogeletey%2Fmilka","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkogeletey%2Fmilka","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkogeletey%2Fmilka/lists"}