{"id":20716311,"url":"https://github.com/conorsheehan1/osxdocker","last_synced_at":"2026-05-03T12:37:33.509Z","repository":{"id":57449798,"uuid":"253103468","full_name":"ConorSheehan1/osxdocker","owner":"ConorSheehan1","description":"A CLI for working with docker on OSX","archived":false,"fork":false,"pushed_at":"2021-04-11T19:12:34.000Z","size":288,"stargazers_count":2,"open_issues_count":7,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-25T01:53:57.676Z","etag":null,"topics":["clear-logs","cli","docker","fire","mac","macos","macosx","osx","poetry","pypi","python","python-fire"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/osxdocker/","language":"Python","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/ConorSheehan1.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}},"created_at":"2020-04-04T21:37:47.000Z","updated_at":"2024-02-05T19:47:35.000Z","dependencies_parsed_at":"2022-09-26T17:31:11.027Z","dependency_job_id":null,"html_url":"https://github.com/ConorSheehan1/osxdocker","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/ConorSheehan1/osxdocker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ConorSheehan1%2Fosxdocker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ConorSheehan1%2Fosxdocker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ConorSheehan1%2Fosxdocker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ConorSheehan1%2Fosxdocker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ConorSheehan1","download_url":"https://codeload.github.com/ConorSheehan1/osxdocker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ConorSheehan1%2Fosxdocker/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265742913,"owners_count":23820930,"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","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":["clear-logs","cli","docker","fire","mac","macos","macosx","osx","poetry","pypi","python","python-fire"],"created_at":"2024-11-17T03:05:26.978Z","updated_at":"2026-05-03T12:37:33.468Z","avatar_url":"https://github.com/ConorSheehan1.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://github.com/ConorSheehan1/osxdocker/workflows/ci/badge.svg)](https://github.com/ConorSheehan1/osxdocker/actions/)\n[![Documentation Status](https://readthedocs.org/projects/osxdocker/badge/?version=latest)](https://osxdocker.readthedocs.io)\n[![PyPI](https://img.shields.io/pypi/v/osxdocker)](https://pypi.org/project/osxdocker/)\n[![PyPI - License](https://img.shields.io/pypi/l/osxdocker)](https://opensource.org/licenses/MIT)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n# osxdocker\nA CLI for working with docker on OSX\n\nCurrently it just handles docker logs, because I found it annoying starting up a screen session to get to the docker vm every time I wanted to clear logs. \nSee: https://stackoverflow.com/questions/42527291/clear-logs-in-native-docker-on-mac\n\n## Install\n```bash\n# installs osxdocker and recommended docker and screen dependencies\nbrew install conorsheehan1/conorsheehan1/osxdocker\n\n# installs osxdocker cli only, assumes you have docker and screen on your path\npip3 install osxdocker\n```\n\n## Usage\n```bash\n# clear logs\nosxdocker clear_log $some_container_name\n\n# list available commands and flags\nosxdocker\n```\n\n![clear_log_example](docs/source/images/clear_log_example.png)\n\nThis cli uses https://github.com/google/python-fire  \nCheck out the docs for more details on usage, setting up bash completion, etc.  \nAlso worth noting:\n1. Because the package uses fire, it can be imported like a normal python package. e.g.\n    ```python\n    from osxdocker.docker_logs import DockerLogs\n    DockerLogs().log_path('foo')\n    ```\n2. This cli doesn't support `--version` due to a quirk with fire.\n    ```bash\n    osxdocker version # works fine\n    osxdocker --version # won't work\n    ```\n\n#### Edge cases and gotchas\nContainer names are unique, but containers are filtered by regex, so you can still run into issues.  \ne.g. You have two containers, named foo and foo_too.  \n`osxdocker cat_log foo` will fail because it matches foo and foo_too.  \n`osxdocker cat_log ^foo$` will work because it matches foo exactly.\n\n![multiple_container_error](docs/source/images/multiple_container_error.png)\n\n#### Developer notes\nSee [docs/source/dev.md](docs/source/dev.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconorsheehan1%2Fosxdocker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fconorsheehan1%2Fosxdocker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconorsheehan1%2Fosxdocker/lists"}