Timber integrates with the command line through the
timber command line utility, allowing you to access and search your logs directly from your terminal.
Static binary with no dependencies
Issue authenticated requests to the Timber API
The Timber CLI ships as a static binary with no dependencies.
Timber is easily installed through the homebrew package manager:
brew tap timberio/brew && brew install timber
You can update
timber over time via:
brew update && brew upgrade timber
If all else fails, you can build
timber from source. Building from source requires the
git clone firstname.lastname@example.org:timberio/cli.git timbercd timbergo build./timber help
We recommend moving
timber into your
To use the Timber CLI you'll need to create an API key. Simply copy your API key and run
timber auth [api_key], replacing
[api_key] with your new API key value.
timber auth [api_key]
This will store your API key in the
~/.timber folder. Going forward, this key will be used for all timber commands. Alternatively, you can supply the
--api-key flag with each command or set the
TIMBER_API_KEY environment variable.
The Timber CLI offers support for switching between multiple organizations:
timber auth list to list your API keys
timber auth switch [org_id] to switch to another API key.
If you don't see your API key, add it as described above.
By default, Timber will use ANSI coloring, you can disable this with the
--monochrome-output flag or by setting the
TIMBER_NO_COLOR env var.
brew updatebrew upgrade timber
Simply delete the
timber binary and re-install it.
Commands and options can be accessed with the
timber help command:
NAME:timber - Command line interface for the Timber.io logging serviceUSAGE:timber [global options] command [command options] [arguments...]VERSION:0.2.0COMMANDS:auth Manage authentication for the Timber CLItail, t Live tails logssources Manage your Timber sourcessql-queries Manage SQL queriesviews Manage your saved views (only console views are supported in the CLI)api Issue authenticated requests to the Timber API (http://docs.api.timber.io)help, h Shows a list of commands or help for one commandGLOBAL OPTIONS:--api-key value, -K value Your timber.io API key [$TIMBER_API_KEY]--color-output, -C Set to force color output even if output is not a color terminal [$TIMBER_COLOR]--max-columns value Maximum number of columns to display in a table (default: 7) [$TIMBER_MAX_COLUMNS]--max-column-length value Maximum length of a single column value (default: 20) [$TIMBER_MAX_COLUMNS]--max-per-page value Maximum number of items to display per page (default: 25) [$TIMBER_MAX_PER_PAGE]--monochrome-output, -M Disable color output [$TIMBER_NO_COLOR]--debug, -D Output debug messages [$TIMBER_DEBUG]--host value, -H value Timber.io host, useful for testing (default: "https://api.timber.io") [$TIMBER_HOST]--time-zone value, -Z value Time zone, such as "Local", "UTC", or "America/New_York" (default: "Local") [$TIMBER_TIME_ZONE]--help, -h show help--version, -v print the version
...and more. Checkout out the main usage section for more guides and tutorials.