# Getting Started ## First launch Before starting the daemon, create `~/.ein/eind.json` with at least one provider profile and model. The [configuration guide](configuration/README.md) contains a complete example. Credentials stay in this server-owned file. Run `ein`. If `eind` is not already running, a release build starts the local service automatically. The TUI receives only the safe profile and model catalog; it never reads or receives the profile's credentials. ## Session picker The **session picker** appears on connection: ``` ┌─ Sessions ──────────────────────────────────────────┐ │ │ │ ○ New Session │ │ ○ 2026-05-06 Debugging the plugin loader │ │ ○ 2026-05-05 Refactoring the render module │ │ │ │ ↑/↓ navigate Enter select Shift+D delete │ └─────────────────────────────────────────────────────┘ ``` Select **New Session** to choose a profile and model, or pick an existing session to resume its full conversation history and persisted model binding. ## Directory access prompt When you start a new session, Ein asks whether the agent should have read/write access to your current working directory: ``` Allow access to /Users/you/myproject? [Y/n] ``` Press `Y` to add it to this connection's workspace roots. Press `N`, `Enter`, or `Esc` to skip. This grant is not written to either configuration file or the session record. ## Your first prompt Type a message and press `Enter`. Watch the agent respond in real time — text streams in as it's generated. When the agent runs a tool you'll see it inline: ``` ▸ Bash ls -la total 48 drwxr-xr-x 12 you staff 384 May 6 11:30 . ... ``` The agent loops, calling tools as needed, until it has a complete answer. While it is working a spinner appears. You may queue another prompt; press `Ctrl+C` to request cancellation, or press it again to quit while a slow tool finishes. ## Next steps - See [Configuration](configuration/README.md) to configure provider profiles, reusable workspace roots, and server-owned network access. - See [Using Ein](using-ein/README.md) for all slash commands, session management, and keyboard shortcuts.