Get Started

Archive your coding sessions locally as plain text JSONL. Sync to your encrypted silo on unfirehose.org when you're ready.

SDKs

Client libraries for building your own integrations. The JSONL schema is open — build a client in any language.

TypeScript

@unturf/unfirehose

Core SDK. Session ingestion, querying, and export.

npm install @unturf/unfirehose
Python

unfirehose

Session ingestion and export for Python applications.

pip install unfirehose
Planned
Go

unfirehose-go

Native Go client for high-performance ingestion.

go get unturf.com/unfirehose
Planned
Rust

unfirehose-rs

Zero-copy JSONL parser and session client.

cargo add unfirehose
Planned
Elixir

unfirehose

OTP-native client with GenStage ingestion pipeline.

{:unfirehose, "~> 0.1"}
Planned
C

libunfirehose

Minimal C library. Embed in any runtime.

make && make install
Planned

npm Packages

Additional TypeScript packages under the @unturf scope. Used internally by the dashboard.

@unturf/unfirehose-router

Express/Next.js route handlers for webhook ingestion and SSE streaming.

@unturf/unfirehose-schema

JSONL event schema definitions and Zod validators.

@unturf/unfirehose-ui

React components for session timelines, diff viewers, and analytics.

Build Your Own

The unfirehose API accepts JSONL over HTTPS. Any language that can make HTTP requests can be a client.

# Push a session as JSONL
curl -X POST https://api.unfirehose.org/v1/sessions \
  -H "Authorization: Bearer unfh-pk-your-key" \
  -H "Content-Type: application/jsonl" \
  --data-binary @session.jsonl