> ## Documentation Index
> Fetch the complete documentation index at: https://docs.penbox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> The few things that look broken and are not.

<AccordionGroup>
  <Accordion title="The agent says it has no workspace" icon="building">
    `list_workspaces` returns zero. The install is fine. Your Penbox account is not a member of any workspace yet.

    Ask your workspace administrator to [add you as a member](/workspace/settings/members), then try again. No reinstall needed.
  </Accordion>

  <Accordion title="I installed the plugin but the tools are not there" icon="eye-slash">
    A plugin installed during a session stays invisible to that session.

    Open a new session. In Claude Code you can also run `/reload-plugins` in the current one.
  </Accordion>

  <Accordion title="Codex stops on an approval prompt" icon="terminal">
    Codex asks you to approve the filesystem write at install, and again the first time a tool runs. `codex exec` cannot answer those prompts.

    Run the install and the first tool call in an interactive Codex session. After that, `codex exec` works.
  </Accordion>

  <Accordion title="A new plugin version does not show up" icon="clock-rotate-left">
    Your client picks up a new version on its next launch, and only when the declared version moved.

    Restart the client. If the version is unchanged, there is nothing new to fetch.
  </Accordion>

  <Accordion title="The browser did not open for sign-in" icon="browser">
    Sign-in happens on the first Penbox tool call, not at install time.

    Ask the agent to list your workspaces. That first call triggers the OAuth flow.
  </Accordion>
</AccordionGroup>

<Card title="Still stuck?" icon="envelope" href="mailto:support@penbox.io">
  Write to [support@penbox.io](mailto:support@penbox.io) with the tool name and the exact refusal message.
</Card>