Getting Started

Send your first log and error to LogNorth in two minutes, from Go, Node.js, Bun, Rails, or any language over HTTP.

Create an app

Open Apps in LogNorth and create one for each app and environment. Copy its key: it starts with lgn-.

Install

# TypeScript / Node.js / Bun
npm install lognorth

# Go
go get github.com/karloscodes/lognorth-sdk-go

Use

import LogNorth from 'lognorth'

LogNorth.config('https://logs.yoursite.com', 'lgn-your-app-key')

LogNorth.log('User signed up', { user_id: 123 })

LogNorth.error('Checkout failed', err, { order_id: 42 })

That’s it. Regular logs batch automatically. Errors send immediately.

Let your agent read them

Sending events is half of it. The other half is reading them without opening a dashboard. Create an agent key in Settings > Developer, then copy the command there:

curl -fsSL https://lognorth.com/cli | sh -s -- https://logs.yoursite.com lgn-agent-...

It connects Claude Code, Codex, and Gemini CLI to eight read-only tools over the log. See MCP.

The same install gives you north tail, which follows the log, and north top, which shows one app live. See Terminal.

Error Detection

Method	Behavior
`LogNorth.log()`	Batched (10 events or 5s)
`LogNorth.error()`	Sent immediately