{"id":47770432,"url":"https://github.com/oleg-koval/dcli","last_synced_at":"2026-05-02T12:01:50.011Z","repository":{"id":348881479,"uuid":"1200019102","full_name":"oleg-koval/dcli","owner":"oleg-koval","description":"Docker Compose and Git management CLI for macOS, Linux, and Windows. Easily clean and restart containers, reset repositories to develop or acceptance branches.","archived":false,"fork":false,"pushed_at":"2026-04-27T08:40:50.000Z","size":4412,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-27T10:27:59.305Z","etag":null,"topics":["cli","cross-platform","docker","docker-compose","git","go","homebrew","linux","macos","windows"],"latest_commit_sha":null,"homepage":"https://github.com/oleg-koval/dcli","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oleg-koval.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-03T00:30:34.000Z","updated_at":"2026-04-27T08:40:49.000Z","dependencies_parsed_at":"2026-04-20T01:00:27.585Z","dependency_job_id":null,"html_url":"https://github.com/oleg-koval/dcli","commit_stats":null,"previous_names":["oleg-koval/dcli"],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/oleg-koval/dcli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oleg-koval%2Fdcli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oleg-koval%2Fdcli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oleg-koval%2Fdcli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oleg-koval%2Fdcli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oleg-koval","download_url":"https://codeload.github.com/oleg-koval/dcli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oleg-koval%2Fdcli/sbom","scorecard":{"id":1245538,"data":{"date":"2026-04-03T11:13:37Z","repo":{"name":"github.com/oleg-koval/dcli","commit":"75a04a0f566e88ff20aec69727da1049eb63580d"},"scorecard":{"version":"v5.3.0","commit":"c22063e786c11f9dd714d777a687ff7c4599b600"},"score":3.1,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#code-review"}},{"name":"CI-Tests","score":-1,"reason":"no pull request found","details":null,"documentation":{"short":"Determines if the project runs tests before pull requests are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#ci-tests"}},{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: SECURITY.md:1","Info: Found linked content: SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: SECURITY.md:1","Info: Found text in security policy: SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#security-policy"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#binary-artifacts"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: jobLevel 'contents' permission set to 'write': .github/workflows/release.yml:79","Warn: no topLevel permission defined: .github/workflows/release.yml:1","Info: topLevel permissions set to 'read-all': .github/workflows/scorecard.yml:9","Warn: no topLevel permission defined: .github/workflows/test.yml:1"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:82: update your workflow using https://app.stepsecurity.io/secureworkflow/oleg-koval/dcli/release.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:85: update your workflow using https://app.stepsecurity.io/secureworkflow/oleg-koval/dcli/release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:88: update your workflow using https://app.stepsecurity.io/secureworkflow/oleg-koval/dcli/release.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/oleg-koval/dcli/release.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:43: update your workflow using https://app.stepsecurity.io/secureworkflow/oleg-koval/dcli/release.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:68: update your workflow using https://app.stepsecurity.io/secureworkflow/oleg-koval/dcli/release.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/scorecard.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/oleg-koval/dcli/scorecard.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/scorecard.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/oleg-koval/dcli/scorecard.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/scorecard.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/oleg-koval/dcli/scorecard.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/oleg-koval/dcli/test.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/oleg-koval/dcli/test.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/test.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/oleg-koval/dcli/test.yml/main?enable=pin","Info:   0 out of   9 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   3 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#pinned-dependencies"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#sast"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dangerous-workflow"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#packaging"}},{"name":"Maintained","score":0,"reason":"project was created within the last 90 days. Please review its contents carefully","details":["Warn: Repository was created within the last 90 days."],"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#maintained"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#cii-best-practices"}},{"name":"Dependency-Update-Tool","score":0,"reason":"no update tool detected","details":["Warn: no dependency update tool configurations found"],"documentation":{"short":"Determines if the project uses a dependency update tool.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dependency-update-tool"}},{"name":"License","score":0,"reason":"license file not detected","details":["Warn: project does not have a license file"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#license"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v0.1.0 not signed: https://api.github.com/repos/oleg-koval/dcli/releases/304967161","Warn: release artifact v0.1.0 does not have provenance: https://api.github.com/repos/oleg-koval/dcli/releases/304967161"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#signed-releases"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#fuzzing"}},{"name":"Contributors","score":0,"reason":"project has 0 contributing companies or organizations -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project has a set of contributors from multiple organizations (e.g., companies).","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#contributors"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#branch-protection"}}]},"last_synced_at":"2026-04-03T16:55:17.728Z","repository_id":348881479,"created_at":"2026-04-03T16:55:17.729Z","updated_at":"2026-04-03T16:55:17.729Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32533344,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T11:28:32.350Z","status":"ssl_error","status_checked_at":"2026-05-02T11:27:30.140Z","response_time":132,"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":["cli","cross-platform","docker","docker-compose","git","go","homebrew","linux","macos","windows"],"created_at":"2026-04-03T09:01:26.102Z","updated_at":"2026-05-02T12:01:49.975Z","avatar_url":"https://github.com/oleg-koval.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/oleg-koval/dcli/actions/workflows/test.yml\"\u003e\u003cimg src=\"https://github.com/oleg-koval/dcli/actions/workflows/test.yml/badge.svg\" alt=\"tests\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://coveralls.io/github/oleg-koval/dcli\"\u003e\u003cimg src=\"https://coveralls.io/repos/github/oleg-koval/dcli/badge.svg\" alt=\"Coverage Status\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://goreportcard.com/report/github.com/oleg-koval/dcli\"\u003e\u003cimg src=\"https://goreportcard.com/badge/github.com/oleg-koval/dcli\" alt=\"Go Report Card\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://securityscorecards.dev/viewer/?uri=github.com/oleg-koval/dcli\"\u003e\u003cimg src=\"https://api.securityscorecards.dev/projects/github.com/oleg-koval/dcli/badge\" alt=\"OpenSSF Scorecard\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./icon.svg\" width=\"120\" height=\"120\" alt=\"dcli icon\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003edcli\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  Lightweight Docker Compose and Git management CLI\u003cbr\u003e\n  \u003cstrong\u003eClean, restart, and manage repositories with a single command\u003c/strong\u003e\n\u003c/p\u003e\n\n---\n\n## Features\n\n- 🐳 **Docker Management** - Clean containers/volumes, rebuild, and restart services\n- 🔄 **Git Batch Operations** - Reset multiple repositories to any branch on origin\n- 🧩 **Custom Command Packs** - Save local automation, share repo-pack commands, and export/import packs for onboarding\n- ⚙️ **Execution-First CLI** - Run commands directly; use `dcli commands` and `dcli commands ui` to manage packs and sharing\n- 🚀 **Homebrew Distribution** - Install with a single command: `brew install dcli`\n- 🔄 **Auto-Updates** - Checks GitHub Releases on launch and self-updates when a newer version is available\n- 🖥️ **Cross-Platform** - Works on macOS (Intel \u0026 Apple Silicon), Linux, and Windows\n- ⚙️ **YAML Configuration** - Simple config file at `~/.dcli/config.yaml`\n- 📝 **Clear Error Messages** - Comprehensive feedback on what went wrong and why\n- 🧪 **Well-Tested** - 58 tests with 82.4% code coverage across all platforms\n\n## Installation\n\n### Using Homebrew (Recommended)\n\n```bash\nbrew tap oleg-koval/dcli\nbrew install dcli\ndcli --version\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/oleg-koval/dcli.git\ncd dcli\nmake build\n./bin/dcli --version\n```\n\n### Direct Download\n\nDownload binaries for your platform from [GitHub Releases](https://github.com/oleg-koval/dcli/releases/tag/v0.1.0)\n\nSet `DCLI_DISABLE_AUTO_UPDATE=1` if you want to skip the startup update check.\nSet `DCLI_AUTO_UPDATE_TIMEOUT=250ms` to adjust the best-effort update check timeout (default: `1s`).\nSet `DCLI_AUTO_UPDATE_CHANNEL=prerelease` (or `beta` / `alpha`) to follow prerelease builds from GitHub Releases instead of stable only.\n\n## Quick Start\n\n### Docker Commands\n\n```bash\n# Clean all services (remove containers, volumes, rebuild, restart)\ndcli docker clean\n\n# Clean specific services\ndcli docker clean api web\n\n# Restart services while preserving data\ndcli docker restart\n\n# Restart specific services\ndcli docker restart api\n```\n\n### Git Commands\n\n```bash\n# Reset all configured repos to develop\ndcli git reset develop\n\n# Reset all configured repos to develop\ndcli git reset develop\n```\n\n### Custom Commands\n\n```bash\n# Add a personal command\ndcli commands add john deploy -- docker compose up -d\n\n# List loaded commands\ndcli commands\n\n# Open the interactive browser for management only\ndcli commands ui\n\n# Export a pack for onboarding\ndcli commands export --file team-pack.json\n\n# Import a shared pack\ndcli commands import --file team-pack.json\n```\n\n## Configuration\n\nCreate `~/.dcli/config.yaml`:\n\n```yaml\nrepositories:\n  - path: /Users/username/projects/backend\n    name: backend\n  - path: /Users/username/projects/frontend\n    name: frontend\n  - path: /Users/username/projects/infra\n    name: infra\n```\n\n### Environment Variables\n\n- `DCLI_PROJECT_DIR` - Override default project directory (defaults to current directory)\n- `DCLI_AUTO_UPDATE_TIMEOUT` - Override the startup update check timeout using a Go duration string, such as `250ms` or `1s`\n\nExample:\n```bash\nDCLI_PROJECT_DIR=/path/to/monorepo dcli docker clean api web\n```\n\n## Commands Reference\n\n### Global Flags\n\n- `-h, --help` - Show help\n- `-v, --version` - Show version\n\n### Docker Subcommand\n\n```\ndcli docker clean [service ...]      # Clean and rebuild (removes containers, volumes, rebuilds)\ndcli docker restart [service ...]    # Restart services (preserves data)\n```\n\n### Git Subcommand\n\n```\ndcli git reset [develop|acceptance]  # Reset all configured repos to specified branch\n```\n\n### Commands Subcommand\n\n```\ndcli commands                         # List loaded commands\ndcli commands show [path...]          # Show details for one command\ndcli commands add [path...] -- \u003ccmd\u003e   # Add a personal command\ndcli commands edit [path...]          # Edit command metadata or replace the step command\ndcli commands enable [path...]        # Enable a command\ndcli commands disable [path...]       # Disable a command\ndcli commands delete [path...]        # Delete a command\ndcli commands export --file \u003cpath\u003e    # Export a command pack\ndcli commands import --file \u003cpath\u003e    # Import a command pack\ndcli commands ui [--export-file \u003cpath\u003e] # Open the command management TUI\n```\n\n## System Requirements\n\n- **Docker** 20.10+ with Docker Compose\n- **Git** 2.20+\n- macOS 10.14+, Ubuntu 18.04+, or Windows 10+\n\n## Documentation\n\n- 📖 [Installation Guide](docs/INSTALL.md) - Detailed installation instructions for all platforms\n- ⚙️ [Configuration Guide](docs/CONFIGURATION.md) - Complete configuration reference with examples\n- 📝 [Contributing](CONTRIBUTING.md) - How to contribute to dcli\n- 🔒 [Security Policy](SECURITY.md) - Reporting security vulnerabilities\n\n## Use Cases\n\n### Development Workflow\n\nReset your working environment to latest develop:\n```bash\ndcli git reset develop      # Fetch and reset all repos\ndcli docker clean           # Clean all containers and volumes\n# Fresh environment ready for new feature branch\n```\n\n### Quick Service Restart\n\nAfter code changes or configuration updates:\n```bash\ndcli docker restart web api  # Restart specific services\n# Preserves database data and volumes\n```\n\n### Monorepo Management\n\nConfigure all microservices and reset with one command:\n```bash\n# In ~/.dcli/config.yaml: add all repo paths\ndcli git reset acceptance    # All services to acceptance branch\ndcli docker clean           # Clean all microservices\n```\n\n## Architecture\n\ndcli is built with:\n- **Go 1.25.0+** - Compiled language for reliability\n- **Cobra** - Battle-tested CLI framework\n- **YAML** - Human-readable configuration\n- **Docker Compose API** - Direct execution without shells\n\nZero external dependencies for core functionality.\n\n## Project Status\n\n- ✅ **Alpha Release** (v0.1.0)\n- ✅ Tests passing (15+ tests)\n- ✅ Cross-platform builds (macOS, Linux, Windows)\n- ✅ Homebrew distribution ready\n- 🚀 Production-ready for Docker Compose and Git workflows\n\n## Contributing\n\nContributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details\n\n## Author\n\n[@oleg-koval](https://github.com/oleg-koval)\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003edcli makes container, repository, and custom command management effortless\u003c/strong\u003e\u003cbr\u003e\n  \u003ca href=\"https://github.com/oleg-koval/dcli/issues\"\u003eReport Issues\u003c/a\u003e •\n  \u003ca href=\"https://github.com/oleg-koval/dcli/discussions\"\u003eDiscussions\u003c/a\u003e •\n  \u003ca href=\"https://github.com/oleg-koval/dcli/releases\"\u003eReleases\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foleg-koval%2Fdcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foleg-koval%2Fdcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foleg-koval%2Fdcli/lists"}