{"id":30020798,"url":"https://github.com/humanlayer/homebrew-humanlayer","last_synced_at":"2026-04-04T19:04:11.135Z","repository":{"id":307393440,"uuid":"1029287314","full_name":"humanlayer/homebrew-humanlayer","owner":"humanlayer","description":null,"archived":false,"fork":false,"pushed_at":"2026-03-13T03:51:32.000Z","size":560,"stargazers_count":17,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-13T06:55:34.808Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/humanlayer.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-07-30T20:04:59.000Z","updated_at":"2026-03-13T03:51:36.000Z","dependencies_parsed_at":"2026-03-13T02:03:42.730Z","dependency_job_id":null,"html_url":"https://github.com/humanlayer/homebrew-humanlayer","commit_stats":null,"previous_names":["humanlayer/homebrew-humanlayer"],"tags_count":558,"template":false,"template_full_name":null,"purl":"pkg:github/humanlayer/homebrew-humanlayer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/humanlayer%2Fhomebrew-humanlayer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/humanlayer%2Fhomebrew-humanlayer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/humanlayer%2Fhomebrew-humanlayer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/humanlayer%2Fhomebrew-humanlayer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/humanlayer","download_url":"https://codeload.github.com/humanlayer/homebrew-humanlayer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/humanlayer%2Fhomebrew-humanlayer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30535856,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-15T05:01:24.307Z","status":"ssl_error","status_checked_at":"2026-03-15T04:58:50.392Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":[],"created_at":"2025-08-06T02:15:40.732Z","updated_at":"2026-03-17T18:16:15.294Z","avatar_url":"https://github.com/humanlayer.png","language":"Ruby","readme":"# HumanLayer Homebrew Tap\n\nThis is a public Homebrew tap for easy installation of HumanLayer tools. No authentication is required.\n\n## Installation\n\n### Single Command Installation (Recommended)\n\n```bash\n# Install directly without adding the tap first\nbrew install --cask --no-quarantine humanlayer/humanlayer/codelayer\n```\n\n### Alternative: Add Tap First\n\n```bash\n# Add the public tap\nbrew tap humanlayer/humanlayer\n\n# Install the cask\nbrew install --cask --no-quarantine codelayer\n```\n\n## PATH Configuration\n\nHomebrew automatically handles PATH setup by creating symlinks for the bundled binaries:\n- `/usr/local/bin/humanlayer` → `/Applications/HumanLayer.app/Contents/Resources/bin/humanlayer`\n- `/usr/local/bin/hld` → `/Applications/HumanLayer.app/Contents/Resources/bin/hld`\n\nThis means:\n- Claude Code can execute `humanlayer mcp claude_approvals` directly (no npx needed)\n- Power users can run `hld` commands if needed\n- No manual PATH configuration required\n\n## Verifying PATH Setup\n\nAfter installation, verify the binaries are accessible:\n\n```bash\n# Check if humanlayer is in PATH\nwhich humanlayer\n# Should output: /usr/local/bin/humanlayer\n\n# Verify it's a symlink to the app bundle\nls -la /usr/local/bin/humanlayer\n# Should show: /usr/local/bin/humanlayer -\u003e /Applications/HumanLayer.app/Contents/Resources/bin/humanlayer\n\n# Test the binary works\nhumanlayer --version\n```\n\n## Updating\n\n```bash\nbrew update\nbrew upgrade --cask codelayer\n```\n\nWhen upgrading, Homebrew automatically updates the symlinks to point to the new app version.\n\n## Set --no-quarantine as default\n\n```bash\nexport HOMEBREW_CASK_OPTS=\"--no-quarantine\"\n```\n\n## Troubleshooting PATH Issues\n\n### Binary not found after installation\n\nIf `humanlayer` command is not found after installation:\n\n1. **Check if `/usr/local/bin` is in your PATH:**\n   ```bash\n   echo $PATH | grep -q \"/usr/local/bin\" \u0026\u0026 echo \"Path is correct\" || echo \"Path needs updating\"\n   ```\n\n2. **If PATH needs updating, add to your shell profile:**\n   ```bash\n   # For zsh (default on macOS):\n   echo 'export PATH=\"/usr/local/bin:$PATH\"' \u003e\u003e ~/.zshrc\n   source ~/.zshrc\n\n   # For bash:\n   echo 'export PATH=\"/usr/local/bin:$PATH\"' \u003e\u003e ~/.bash_profile\n   source ~/.bash_profile\n   ```\n\n3. **Verify Homebrew created the symlinks:**\n   ```bash\n   ls -la /usr/local/bin/ | grep -E \"humanlayer|hld\"\n   ```\n\n4. **If symlinks are missing, reinstall the cask:**\n   ```bash\n   brew uninstall --cask codelayer\n   brew install --cask --no-quarantine humanlayer/humanlayer/codelayer\n   ```\n\n### Claude Code can't find humanlayer\n\nIf Claude Code shows errors about `humanlayer` not being found:\n\n1. **Ensure Claude Code was restarted after installation**\n2. **Check Claude Code's PATH environment:**\n   - Claude Code inherits PATH from how it was launched\n   - If launched from Dock/Spotlight, it may have a limited PATH\n   - Try launching Claude Code from Terminal: `open -a \"Claude Code\"`\n\n### Development vs Production Binaries\n\n- **Production**: Uses bundled binaries from `/Applications/HumanLayer.app/Contents/Resources/bin/`\n- **Development**: Should use globally installed `humanlayer` (via npm/bun)\n- **Never mix**: Don't try to use production binaries in development","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhumanlayer%2Fhomebrew-humanlayer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhumanlayer%2Fhomebrew-humanlayer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhumanlayer%2Fhomebrew-humanlayer/lists"}