What It Is

Elephant Agent starts from the person, not the task.

The mother elephant grows a correctable Personal Model of who you are, what surrounds you, what is alive right now, and what your path has taught you. That understanding keeps deepening through interaction, correction, and gentle questions.

Once Elephant Agent understands enough, it can help design living Paths: work, health, habits, learning, relationships, recovery, research, code, and any other long-running direction you want to move. It can break a Path into Steps, bring in baby elephants when useful, and return to you at Checkpoints where your judgment matters.

Personal Agent Levels

Personal Model

• Identity — who you are, your values, boundaries, decision style, and stable preferences.
• World — the people, projects, tools, places, and relationships around you.
• Pulse — what is alive right now: focus, pressure, constraints, energy, and priorities.
• Journey — what your path has taught: lessons, failures, recovery patterns, and long-running growth.

The goal is not to remember everything. The goal is to understand what matters, show why it matters, let you change it, and turn that understanding into better Paths over time.

macOS Desktop App

The macOS app is the recommended product surface. Chat / Wake is where you talk to Mother; Paths are where long-running life and work arcs become visible; the rest of the app keeps the Personal Model, Herd, skills, messaging, calendar, usage, and advanced runtime settings inspectable instead of hidden behind a chat box.

_{Home — start from what Mother understands before shaping the next Path.}

Preferences Choose language, boundaries, model posture, and curiosity effort.	Chat / Wake Return to Mother and the same path, not a blank prompt.
Personal Model Inspect the understanding that shapes future Paths.	Providers Use local or hosted models as advanced posture, not the product center.
Skills See which skills help Mother and the Herd move a Path.	Tools Keep browser, filesystem, MCP, and operator actions explicit.
Herd Coordinate Mother and baby elephants under one understanding.	Messaging Connect WeChat, Feishu, Discord, DingDing, or WeCom when you want it.
Calendar Keep routines, reminders, and long-running Paths visible.	Usage Inspect local token flow and runtime events instead of treating cost as a black box.

Quickstart

Elephant Agent has two supported product shapes.

1. macOS desktop app (recommended)

Use this path for the full local desktop workspace: Chat / Wake, Paths, Personal Model, Herd, skills, messaging, calendar, usage, and settings in one native app.

1. Download the latest macOS build from GitHub Releases.
2. Open Elephant Agent.app.
3. Create your first elephant, choose a provider, and set curiosity effort.
4. Return through Chat / Wake when you want Mother to continue the same path.

2. CLI + Dashboard (Linux / Cloud)

Use this path for Linux, cloud machines, SSH workflows, and terminal-first operators. The CLI is the daily terminal surface; the Dashboard is the visual inspection surface for Personal Model, evidence, jobs, skills, and runtime state.

CLI

Dashboard

Install:

curl -fsSL https://elephant.agentic-in.ai/install.sh | bash

First run:

elephant init        # choose identity, provider, and curiosity effort
elephant status      # check provider and local runtime readiness
elephant wake        # enter the chat TUI
elephant dashboard   # open Personal Model, questions, evidence, and runtime state

For remote or cloud use, elephant dashboard --no-open prints the local URL so you can attach through your preferred tunnel or browser setup.

Read More

README and the homepage stay product-first. The deeper system story lives here:

• Read the docs →
• Read the paper →
• Read the blog →

Contributors

Agentic Intelligence Lab