Getting Started #
First launch #
Before starting the daemon, create ~/.ein/eind.json with at least one provider
profile and model. The configuration guide 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 to configure provider profiles, reusable workspace roots, and server-owned network access.
- See Using Ein for all slash commands, session management, and keyboard shortcuts.