# Getting started

> Pull components into your project with the CLI and compose your first walkable world.

Runek ships as a source registry. The `runek` CLI copies editable component source into your project and installs what it needs.

## Install components

```bash
npx @runek/cli init                          # writes runek.config.json + the install dir
npx @runek/cli add player terrain bookshelf  # pulls source + installs deps
npx @runek/cli list                          # browse the catalog
```

`add` resolves dependencies for you: it installs `@runek/core` (the `<World>` provider, seeded `rng`, and contract types) from npm, and `house` pulls the walls, floor, roof, door, and window it composes from as source.

Working with a coding agent? Point it at [Runek for agents](https://runek.nullorder.org/docs/for-agents.md) (or [llms.txt](https://runek.nullorder.org/llms.txt)).

## Compose a world

The CLI copies components into `src/runek/` by default; they import the runtime from `@runek/core`, which it installs for you:

```tsx
import { World } from '@runek/core'
import { Bookshelf } from './runek/Bookshelf'
import { Player } from './runek/Player'
import { Terrain } from './runek/Terrain'

export function FirstWorld() {
  return (
    <World>
      <Terrain size={[40, 40]} />
      <Bookshelf position={[0, 1, 0]} seed={42} />
      <Player />
    </World>
  )
}
```

`<World>` sets up the canvas, lighting, physics, and keyboard controls. `<Player>` is a first-person controller by default — drop in and walk: WASD moves, the arrow keys or a mouse-drag steer the camera. The world's [`avatar` and `controls` settings](https://runek.nullorder.org/docs/the-world-provider.md#controls) change the view and the bindings.

## Same seed, same world

Geometry is a pure function of props and `seed`. The same `seed` produces the same bookshelf — the same books, the same arrangement — on every machine, every render. Change the seed to roll a new variation; commit the number to lock it forever.