A safe, simple, extensible, and fast agent harness
ein book src getting-started.md
2.5 kB · 62 lines
Markdown
at main

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.