# Guides

[Read this page in HTML](https://www.scopedb.io/docs/guides)

Start with a first query, follow a complete example, or go straight to the task you need to finish.

## Run your first query

The [quickstart](https://www.scopedb.io/docs/guides/quickstart.md) takes you from an empty table to your first event query in the Console. You only need a ready workspace and your browser sign-in.

Writing from an application or terminal? [Connect a client](https://www.scopedb.io/docs/guides/connect-to-scopedb.md) to get an API key, configure the address, and check the connection.

### Start with your agent

Paste this prompt into an agent with web and terminal access. It installs the ScopeDB skill, connects to your workspace, helps you answer your first question with read-only queries, and turns results into interactive charts you can open offline.

```text
Install the ScopeDB skill from https://github.com/scopedb/scopedb-skills and help me get started.
```

For manual installation, workspace context files, and chart export with ScopeView, see the [Agent skill guide](https://www.scopedb.io/docs/guides/agent-skill.md). For account setup and supported agents, see the [agent setup FAQ](https://www.scopedb.io/agent#faq-heading).

## Follow a complete example

See what you can build before adapting the workflow to your own data. Each tutorial walks through a runnable producer project, streams events into ScopeDB, and runs the queries that turn raw rows into an operational or analytical result.

**[Investigate application errors](https://www.scopedb.io/docs/guides/investigate-application-errors.md)** keeps a checkout simulator sending logs with the JavaScript SDK. Use Console to locate the release and payment gateway behind a failure spike as requests arrive.

**[Analyze Bluesky activity](https://www.scopedb.io/docs/guides/analyze-bluesky-activity.md)** keeps a Go SDK producer writing live public activity while a fixed sample helps you check the analysis. Compare new posts, replies, and reactions in Console without double-counting replays.

**[Analyze Cloudflare Worker traffic](https://www.scopedb.io/docs/guides/analyze-cloudflare-worker-traffic.md)** deploys a single Tail Worker in your Cloudflare account to stream Worker invocations, logs, and exceptions into ScopeDB. Separate browser document navigations, background prefetches, and AI crawler or Markdown reads, and export interactive charts with ScopeView.

## Complete a specific task

Use **Work with events** when you know what you want to do. Examples run in the Console or through a client.

| Task                                                | Guide                                                                            |
| --------------------------------------------------- | -------------------------------------------------------------------------------- |
| Choose stable columns and keep changing payloads    | [Model event data](https://www.scopedb.io/docs/guides/model-flexible-events.md)  |
| Load new events and check the result                | [Ingest events](https://www.scopedb.io/docs/guides/ingest-events.md)             |
| Find failures, inspect payloads, and compare counts | [Query events](https://www.scopedb.io/docs/guides/query-events.md)               |
| Make recurring filters and searches faster          | [Add indexes](https://www.scopedb.io/docs/guides/add-indexes.md)                 |
| Decide how long to keep a table's data              | [Set data retention](https://www.scopedb.io/docs/guides/data-retention.md)       |
| Understand table size and reduce query work         | [Understand storage](https://www.scopedb.io/docs/guides/storage-architecture.md) |

## Build with a client

The [SDK overview](https://www.scopedb.io/docs/guides/sdks.md) helps you choose a client and check its published version and runtime requirements. Follow the [JavaScript](https://www.scopedb.io/docs/guides/sdks/nodejs.md), [Go](https://www.scopedb.io/docs/guides/sdks/go.md), or [Rust](https://www.scopedb.io/docs/guides/sdks/rust.md) guide to query, write events, and manage table definitions from your application.

Use the [ScopeDB CLI](https://www.scopedb.io/docs/guides/scopedb-cli.md) for interactive queries, shell scripts, and automation. For request and response contracts or a custom HTTP client, use the [API reference](https://www.scopedb.io/docs/api-reference.md).

## Find your way around

[Use the Console](https://www.scopedb.io/docs/guides/cloud-concepts.md) for illustrated help with [Tables](https://www.scopedb.io/docs/guides/console-tables.md), [Explore](https://www.scopedb.io/docs/guides/console-explore.md), and [Query](https://www.scopedb.io/docs/guides/console-query.md).

**Manage your workspace** covers [API keys](https://www.scopedb.io/docs/guides/authentication.md), [members](https://www.scopedb.io/docs/guides/console-members.md), [usage](https://www.scopedb.io/docs/guides/console-usage.md), and [workspaces and sessions](https://www.scopedb.io/docs/guides/console-workspaces.md).

For exact language behavior, look up the [ScopeQL reference](https://www.scopedb.io/docs/reference.md).