Introducing Calibre CLI

Ben Schwarz

Ben Schwarz

April 17, 2018

CLI is a crucial part of a comprehensive system that helps to improve and automate monitoring speed.

Here’s what the command line interface can do for you:

  • Retrieve speed metrics from Calibre, for integration with pre-existing custom reporting, dashboards or data warehousing.
  • Run a Calibre Snapshot following a deployment, then retrieve the metrics.
  • Add speed testing as part of your continuous integration suite.
  • And more!

📊 Seamless metrics export

Metrics are most useful when they’re easy to access. Getting stats out of Calibre is as trivial as a one-liner.

calibre site get-pulse-metrics fetches metrics from a given page, whereas calibre site get-snapshot-metrics --site=ryanair --snapshot=1628 will retreive metrics for a given point in time.

Adding a --json or --csv flag, returns machine readable data. Pushing data to a spreadsheet or dashboard software has never been so effortless.

Calibre CLI
`get-pulse-metrics` returns up to 30 days of metrics

🆕 One-off, shareable page tests

A screenshot of a one-off page test in terminal
A screenshot of a one-off page test in terminal

One-off tests can be run from 17 test locations around the world, emulating connection speeds and devices, all with a single command.

Each one-off page test is stored in your team account forever.

Retrieving metrics for a pre-existing test is only a calibre test show <uuid> away.

Getting fast feedback is important — that’s why we’ve created one-off page tests.

A one-off test, formatted as JSON, colourised by jq.
A one-off test, formatted as JSON, colourised by jq.

Finally, we understand that not everyone is near a terminal window all day. Each test has a secret (but publicly sharable) URL, so you can share reports with the executive team, project managers and coworkers, even if they don’t have a Calibre account.

Because the test result pages are publicly accessible to anyone with a link, it’s possible to use them to showcase speed metrics and improvements in blog posts or case studies., tested by Calibre, tested by Calibre

🖥 Built with Node.js

Most of our customers build for the Web—they have familiarity with the Node.js or JavaScript ecosystem, which is one of the reasons we chose to build CLI using Node.

By using CLI’s Node.js API, you’ll have all the power of Calibre at your fingertips. We created a couple of examples on GitHub to help you get started.

💡🏡 Google’s Lighthouse, built in

Every Calibre test runs Lighthouse, which provides a set of performance, best practice and accessibility audits, developed by the Google Chrome Devtools team. More power, less tooling.

🎬 Getting started with CLI

You’ll need a Calibre account to use CLI. There’s a free, 15-day trial, and we’re more than happy to help if there’s any questions along the way.

We can’t wait to see what you do with it!

🚀 Help us make the Web faster for everyone!

Calibre is a bootstrapped company. Every new customer allows us to continue growing and playing a part in making the Web a faster place for everyone.

Ben Schwarz

Ben Schwarz

Ben is the founder and CEO of Calibre. He uses his experience in far-reaching Open Source projects and web standards to build tools for a better, more accessible web. Find him on Twitter or LinkedIn.

Become a site speed expert

Join thousands of subscribers keeping up-to-date with web performance news and advice.

The best performance newsletter I’ve come across. Highly recommended.

Addy Osmani

Addy Osmani

Engineering Manager at Google Chrome