# Troubleshooting

> The bugs we see the most in the Dailybot CLI, ranked by frequency, with copy-paste fixes.

Language: en
Canonical: https://www.dailybot.com/developers/cli-troubleshooting
Markdown: send header `Accept: text/markdown` on any URL to receive Markdown instead of HTML.
Last Updated: 2026-07-02

---

If a CLI command is misbehaving, one of the entries below is almost certainly the reason. They're ordered by how often we see them in support.

<details>
<summary><strong><code>401 Unauthorized</code> on every command</strong></summary>

Your session or API key isn't being resolved. Run `dailybot me` — if it also 401s, run `dailybot login` (personal use) or verify `$DAILYBOT_API_KEY` is set in the current shell. In containers, ensure the env var is passed through (`docker run -e DAILYBOT_API_KEY …`).

</details>

<details>
<summary><strong><code>403 Forbidden</code> on a specific endpoint</strong></summary>

You're hitting one of the four CLI-only endpoints with an API key. Only `dailybot login` can call `/v1/cli/updates/`, `/v1/cli/status/`, `/v1/cli/chat/completions/`, and `/v1/cli/auth/*`. Everything else works with either credential.

</details>

<details>
<summary><strong><code>429 Too Many Requests</code></strong></summary>

You hit a scope's rate limit. Honor the `Retry-After` header. See [/developers/rate-limits](/developers/rate-limits) for scope names and quotas. Add jitter when retrying.

</details>

<details>
<summary><strong>The CLI hangs on <code>dailybot login</code></strong></summary>

The browser tab didn't complete OTP. Cancel with Ctrl-C and re-run. If your machine can't open a browser, follow the URL that `dailybot login` prints in a browser on another device.

</details>

<details>
<summary><strong>Report doesn't appear in the team feed</strong></summary>

Two common causes: (1) the report went to a different org because you have a stale session — check `dailybot me`; (2) the repo's `.dailybot/disabled` is present. Delete it or unset the opt-out.

</details>

<details>
<summary><strong>AI-agent hook fires too often</strong></summary>

If your harness installs the Dailybot reporting hook, silence it for a repo by creating an empty file at `.dailybot/disabled`. See [/developers/cli-configuration#opting-out-of-local-hooks](/developers/cli-configuration#opting-out-of-local-hooks).

</details>

<details>
<summary><strong><code>Command not found: dailybot</code></strong></summary>

If installed via pipx, ensure `~/.local/bin` is on `$PATH`. If via npm, ensure the global npm prefix is on `$PATH` (`npm prefix -g`).

</details>

<details>
<summary><strong>Which credential am I using right now?</strong></summary>

Run `dailybot me`. The command prints your current identity and the credential type in use.

</details>

<details>
<summary><strong>How do I rotate a leaked API key?</strong></summary>

Revoke it in your Dailybot dashboard immediately. Any pipeline using it will start 401-ing on the next call; rotate the secret in your CI vendor and re-deploy the job.

</details>

<h2 id="support">Still stuck?</h2>

Open a ticket at [dailybot.com/help](/help) or drop into the community. Include the CLI version (`dailybot --version`), the full command you ran, and any redacted error output.

---

## Developer portal navigation

**Getting Started**

- [Overview](/developers)
- [Quick start](/developers/getting-started)
- [Authentication](/developers/authentication)

**API Reference**

- [API Overview](/developers/api)
- [Users](/developers/api/users)
- [Organization](/developers/api/organization)
- [Teams](/developers/api/teams)
- [Invitations](/developers/api/invitations)
- [Check-ins](/developers/api/check-ins)
- [Forms](/developers/api/forms)
- [Report channels](/developers/api/report-channels)
- [Templates](/developers/api/templates)
- [Kudos](/developers/api/kudos)
- [Mood tracking](/developers/api/mood)
- [Important dates](/developers/api/important-dates)
- [Messaging](/developers/api/messaging)
- [Automations](/developers/api/workflows)
- [Webhooks](/developers/api/webhooks)
- [Commands platform](/developers/api/commands-platform)
- [Agents](/developers/api/agents)
- [OAuth2](/developers/api/oauth2)
- [Integrations](/developers/api/integrations)
- [CLI](/developers/api/cli)

**API guides**

- [Errors & Status Codes](/developers/errors)
- [Rate Limits](/developers/rate-limits)
- [Conventions](/developers/conventions)
- [API Changelog](/developers/api-changelog)
- [Recipes](/developers/recipes)

**Developer Features**

- [Custom commands](/developers/custom-commands)
- [Serverless commands](/developers/serverless)
- [Webhooks & events](/developers/webhooks)
- [Automation API trigger](/developers/workflow-trigger)
- [Activity API](/developers/activity-api)

**CLI**

- [Overview](/developers/cli)
- [Authentication](/developers/cli-authentication)
- [Command reference](/developers/cli-reference)
- [CI/CD recipes](/developers/cli-ci-cd)
- [Configuration](/developers/cli-configuration)
- [Troubleshooting](/developers/cli-troubleshooting) (this page)

**Agent Skill**

- [Overview](/developers/agent-skill)
- [Skills catalog](/skills)

---

## Site navigation

**Product:**
- [Home](/)
- [Product](/product)
- [Pricing](/pricing)
- [Enterprise](/enterprise)
- [Integrations](/integrations)
- [Templates](/templates)

**Resources:**
- [Blog](/blog)
- [Academy](/academy)
- [Changelog](/changelog)
- [Help Center](/help)
- [Developers](/developers)
- [Agents](/agents)

**Company:**
- [About](/about)
- [Careers](/careers)
- [Security](/security)
- [Contact Sales](/demo)

**Connect:**
- [LinkedIn](https://www.linkedin.com/company/dailybot/)
- [X/Twitter](https://twitter.com/dailybot)
- [GitHub](https://github.com/Dailybot-Inc)
- [YouTube](https://www.youtube.com/channel/UC3uM9V52vwX7e3vQpCc4qvA)