# Quick Start

> Developer quick-start for xberg-io repos — prerequisites, initial setup, and the core build/test/lint workflow. Load when onboarding to a repo or setting up a local dev environment for the first time.

- Skill: `kreuzberg-dev/quick-start` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kreuzberg-dev/quick-start`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kreuzberg-dev/quick-start/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: kreuzberg-dev (https://skillmd.com/u/kreuzberg-dev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kreuzberg-dev/quick-start

---


# Developer Quick Start

## Prerequisites

- Rust 1.75+ (stable or nightly for WASM)
- Python 3.10+ with uv package manager
- Node.js 18+ with pnpm ≥10.17
- Ruby 3.2+ with rbenv
- PHP 8.2+ with Composer
- Go 1.25+ (optional, for Go binding)
- Java JDK 22+ (optional, for Java binding)
- .NET 8.0+ SDK (optional, for C# binding)
- Task (task runner)
- Poly (multi-language linter and formatter)

## Quick Setup

```bash
# Clone the project repository and cd into it

# Install all dependencies
task setup

```

## Running Tests

```bash
# Core tests
task test

# All binding languages (alef drives the per-language suites)
task test:bindings

# Everything: Rust core + bindings
task test:all

# The languages that expose their own test task
task rust:test
task swift:test
task dart:test
task zig:test

# Coverage
task cov:rust
task cov:all
```

## Development Workflow

```bash
# Build core only
task build

# Build bindings or everything explicitly
task build:bindings
task build:all

# Regenerate Alef-managed files
task alef:generate

# Format repo code (poly handles all formatting)
task format

# Lint everything
task lint

# Generated e2e suites
task e2e:generate
task e2e:build
task e2e:test
task e2e:all

# Run benchmarks (name varies by repo — check task --list; e.g. benchmark:run, bench:run, rust:bench)
task benchmark:run

# Update dependencies
task update
```

## Editing & Committing

1. Edit source files (Rust, Python, TypeScript, Ruby, PHP, etc.)
1. Run `poly fmt --fix .` and `poly lint .` to format and lint code
1. If hooks reject, fix issues and retry git commit
1. Never use --no-verify; enforce code quality