Install the browser extension
For members, managers and admins
This page shows members, managers and admins how to install the ChronoTab browser extension and connect it to their organisation, so time can be logged without leaving a GitHub issue. The extension works in Chrome and Edge only.
Install it
Section titled “Install it”- Open the ChronoTab listing in the Chrome Web Store: ChronoTab.
- Check that the listing is named ChronoTab and described as Track time directly from GitHub issues, then click Add to Chrome and confirm.
- Pin the extension to your toolbar so the button is always visible (in Chrome, open the extensions puzzle-piece menu and choose the pin next to ChronoTab).
Connect it to your organisation
Section titled “Connect it to your organisation”The extension needs to know who you are and which organisation’s repositories it may act on. Connecting it hands the extension a key for one organisation:
- Click the ChronoTab button in your toolbar. Until it is connected, the popup reads Sign in to log time from GitHub issues.
- Select Sign in. This opens the ChronoTab dashboard in a new tab with the connection flow already running. (If you do not have a ChronoTab organisation yet, choose New to ChronoTab? Get started instead.)
- Sign in to ChronoTab if you are not already, and wait for the confirmation that the extension is connected. You can close the tab afterwards.
You can also connect from inside the dashboard: go to Settings and find the Browser extension section, then select Connect extension. The status line reads Connected (this org included) once it has worked.
You are not asked to copy or paste a code. If you belong to more than one organisation, connect the extension to each one from that organisation’s Settings page.
What you see on a GitHub issue
Section titled “What you see on a GitHub issue”Once connected, open any issue in a tracked repository — the extension logs time against issues only, so nothing appears on pull request pages. It adds:
- A floating button on the page showing the ChronoTab logo; hover over it to see the time already logged on that issue, such as 2h 30m logged.
- A Log time button inside the drawer that opens when you click it. The drawer is titled Time on this issue, shows the issue’s title, and lists the entries already recorded there.
- Keyboard shortcuts: Alt+T (or ⌥+T on a Mac) opens and closes the drawer, and Alt+N (or ⌥+N) starts a new entry.
The button and drawer follow GitHub’s own light or dark theme. The toolbar popup follows your operating system’s light or dark setting.
If the extension is not connected yet, an issue page shows a small Set up ChronoTab for owner prompt (naming the repository’s GitHub owner) instead of the button. It links to Get started, and you can dismiss it.
See Log time from GitHub for the full walkthrough.
Managing connections
Section titled “Managing connections”Open the extension’s Settings to see every organisation it is connected to (each row has a Disconnect button), and to replace the key. A link, Manage your defaults on the web profile, opens your Profile, where you set your timezone, default activity type and default billable setting for each organisation. The extension has no separate copy of these: new entries you log from GitHub start on the same defaults as the web Log time sheet, and the popup’s weekly summary follows your profile timezone. If you had chosen any of these in the extension before, they were carried over to your profile automatically, only where the profile had no value yet.
Once connected, the popup lists your week day by day, with a full-width Open My week button that opens My week in a new tab.
The extension keeps a queue of entries that have not yet been sent to ChronoTab. Open the extension popup to see how many are waiting — for example 3 entries unsynced — with a Retry sync button; when nothing is waiting it reads Synced. If you are not connected to an organisation yet, the popup shows the Sign in panel instead.
Need help? Email support@chronotab.com.