Skip to main content

Getting Started with ToolJump

ToolJump revolutionizes developer experience by making it easy to connect your tools - GitHub, AWS, Datadog, CI/CD, and more - with a single context bar that delivers Knowledge as a Service directly in your workflow. Get started in just a few minutes with our step-by-step guide.


Step 1: Install the Chrome Extension

ChromeInstall ToolJump Chrome Extension


The extension installs in Demo Mode, so you can see ToolJump in action immediately.

Pin the Extension

Make sure to pin the ToolJump extension to your Chrome toolbar for easy access:

Pin the ToolJump extension

Step 2: Try the Demo

Visit our demo repository to see ToolJump in action. This is just a demo so that you can see how ToolJump would look like on your repositories (or other engineering tools). You'll see a context bar at the top of the GitHub page showing:

  • Real-time alerts from your monitoring tools
  • Quick links to logs, costs, and deployment status
  • Team information like who's on-call
  • Environment URLs for different deployments

To adapt it to your company and workflows, follow the next steps!

What you'll see in the ToolJump bar

ToolJumpdatadog3 alertsdatadogLogsCost 30d: $351pagerdutyOncall: JohncircleciDeployed 3d ago
URLs
... Other items ...

Demo Mode: This shows sample data. To connect your real tools, continue to Step 3.


Step 3: Set Up Your Server locally

To connect your actual tools and data, you'll need to run your own ToolJump server.

Prerequisites

Make sure you have these installed:

  • Node.js 20+
  • Yarn or NPM

Quick Setup

  1. Create your server:

    npx create-tooljump
  2. Start the server:

    npm run dev
  3. Configure the extension:

    • Open ToolJump extension settings
    • Turn off "Demo Mode"
    • Enter your server URL and the secure token you chose at step 1
    Extension Settings
  4. Test the connection: Visit https://github.com/tooljump/tooljump and you should see your ToolJump bar!

The server comes with a few demo integrations that showcase what's possible with ToolJump.

Want to understand the technical details? Read about our server architecture and Chrome extension architecture.

To adapt it to your company and workflows, follow the next steps!


Step 4: Build Your First Integration

Now that your setup works, it's time to connect your tools and build custom integrations.

Ready to build?

Learn how to create integrations for your specific tools and workflows or browse our gallery of predefined integrations connecting more than 10+ tools.

Also explore integration recipes for specific tools like AWS, Datadog, and GitHub.


Need Help?

  • Extension not working? Check that it's pinned and try refreshing the page
  • Server won't start? Make sure Node.js 20+ is installed and ports aren't blocked
  • Can't see the bar? Verify you're on a supported site and demo mode is configured correctly

For more help, check our troubleshooting guide or join our community.