Getting Started with Taskless CLI

The Taskless CLI provides a powerful, self-hosted solution for API telemetry. This guide will walk you through setting up Taskless CLI from installation to running your first instrumented application.

1. Installing the Taskless Loader
2. Installing Taskless Packs
3. Modifying your start command

Why Choose the CLI Over Cloud?

The Taskless CLI is perfect for teams and developers who prioritize:

• A full open source solution - Packs and the loader are fully open source
• Need Cloudflare deployment - Webassembly packs cannot be loaded on demand in the Cloudflare environment. The CLI enables usage of packs with a Cloudflare deploy.
• Existing telemetry - Use Taskless alongside your current observability tools without vendor lock-in

Install the Taskless Loader

The Taskless loader is the core component that instruments your application. Install it for your programming language:

Node.js

sh npm install @taskless/loader

Install Taskless Packs

Taskless packs contain the instrumentation logic for specific services and libraries. Install packs using the Taskless CLI, which is available via npx or pnpx:

Install a Pack

pnpx @taskless/pack install <pack-url>

Find More Packs

Browse the complete catalog of available packs on GitHub: https://github.com/topics/taskless-pack

Start Your Application

Once you have the loader and packs installed, you can start your application with Taskless instrumentation:

Node.js - package.json

{
  "scripts": {
    "start": "node --import=@taskless/loader ./src/index.js"
  }
}

Additional configuration can be found in the Taskless Loader for Node.js docs