Skip to main content

CLI / Chat TUI

The CLI is the front door. The chat TUI is where the same elephant keeps the thread alive.

Elephant Agent should feel local, inspectable, and calm: one command to start, one wake surface to continue, and slash commands when you need to inspect the runtime without leaving the conversation.

Core flow

StepCommandWhat it does
Installcurl -fsSL https://elephant.agentic-in.ai/install.sh | bashWrites the launcher and local runtime.
First shapeelephant initCreates identity, first elephant, provider posture, and curiosity defaults.
Readinesselephant statusConfirms model, provider, embedding, and active elephant readiness.
Continueelephant wakeOpens the durable chat surface for the current elephant.
Inspect/status, /memory, /tools, /skillsKeeps runtime state visible inside the TUI.
tip

Most days should start with elephant wake, not with a new setup flow. wake returns to the active elephant and projects the current Personal Model into the conversation.

What init creates

elephant init is not just a configuration wizard. It gives the first elephant enough shape to begin learning responsibly.

Init areaWhy it exists
IdentityGives the elephant a name and relationship posture.
ProviderConfirms where dialogue and reasoning come from.
EmbeddingsConfirms local recall or an explicit override.
CuriositySets how willing Elephant Agent is to ask.
First elephantCreates the continuity line wake will return to.

Wake as the main surface

Inside wake, the conversation is primary. Tools, skills, models, memory, and providers stay close but do not become the product center.

NeedSlash commandDashboard counterpart
Check readiness/statusOverview / Settings
Inspect understanding/memoryYou, Diary, Why views
Inspect tools/toolsTools
Inspect skills/skillsSkills
Change provider/model posture/providers, /modelsModels / Providers
Messaging setup/gatewayMessaging
Scheduled work/cronJobs

Local-first posture

Local runtime

Elephant Agent runs as a local runtime. The CLI, TUI, dashboard, gateway, cron, and local state all resolve back to the same Elephant Agent home.

The TUI is designed around three promises:

  • continuity — the same elephant can resume later
  • inspection — the important surfaces have slash commands or dashboard pages
  • correction — when understanding is wrong, update the Personal Model rather than teaching a hidden profile

When to use what

SurfaceUse it when...
elephantYou want the landing and next-step guidance.
elephant initYou are setting up this install for the first time.
elephant wakeYou want to continue with the current elephant.
elephant wake --message "..."You want a single non-interactive turn.
elephant dashboardYou want to inspect or correct understanding visually.
elephant gateway setupYou want Elephant Agent to meet you in messaging apps.