Skip to main content

Elephant Agent CLI-first persistent agent runtime.

Project description

Elephant Agent follows a personal path with people, places, risks, rhythms, decisions, and a Personal Model

Elephant Agent

Do more without thinking less.
Agency-first personal AI, built around you.

Website · Blog · Paper

What It Is

Elephant Agent helps you hand work to agents without handing over your judgment.

Most agent products optimize for doing tasks faster. Elephant Agent adds the missing loop: a correctable Personal Model of what matters to you, what has evidence, what is still a question, and what should shape future help.

That is the L4 position: personal AI should make the person more capable over time, not just automate more sessions.

Personal Agent Levels

Four levels of personal AI with Elephant Agent positioned at L4

L1
Executes tasks.
Claude Code, Cursor, Devin, and Codex-style agents make execution cheaper and faster.
L2
Carries context.
OpenClaw publicly emphasizes local agents, persistent memory, full system access, skills, plugins, and integrations.
L3
Improves procedures.
Hermes Agent publicly positions itself around a self-improving learning loop, skill creation, recall, and user modeling.
L4
Elephant Agent's product position.
Personal AI should help the user keep judgment, evidence, questions, and growth.

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 four Personal Model lenses: Identity, World, Pulse, and Journey

The goal is not to remember everything. The goal is to understand what matters, show why it matters, and let you change it.

macOS Desktop App

The macOS app is the recommended product surface. Chat / Wake is where you continue the same path; the rest of the app keeps the Personal Model, providers, skills, tools, messaging, jobs, and runtime state visible instead of hidden behind a chat box.

Elephant Agent macOS Home screen with the Personal Model map, current context, and next useful question
Home — start from the Personal Model before delegating work.

Elephant Agent onboarding language screen
Preferences
Choose language, boundaries, model posture, and curiosity effort.
Elephant Agent Wake chat surface
Chat / Wake
Return to the same elephant, not a blank prompt.
Elephant Agent Personal Model map
Personal Model
Inspect Identity, World, Pulse, and Journey as correctable claims.
Elephant Agent model provider settings
Providers
Use local or hosted models without turning the provider into the product.
Elephant Agent skills screen
Skills
See which skills match your Personal Model and active work.
Elephant Agent tools screen
Tools
Keep browser, filesystem, MCP, and operator actions explicit.
Elephant Agent herd screen
Herd
Coordinate the mother elephant and local baby agents under one context.
Elephant Agent messaging integrations
Messaging
Connect WeChat, Feishu, Discord, DingDing, or WeCom when you want it.
Elephant Agent calendar and reminders
Calendar
Keep reminders and scheduled agent work visible in one place.
Elephant Agent token usage screen
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, Personal Model, providers, skills, tools, herd, messaging, reminders, 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 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 work surface; the Dashboard is the visual inspection surface for Personal Model, evidence, jobs, skills, and runtime state.

Elephant Agent CLI wake session
CLI
Elephant Agent Dashboard Personal Model map
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:

Contributors

Agentic Intelligence Lab

Agentic Intelligence Lab

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

elephant_agent-1.0.0.dev20260526151829.tar.gz (1.6 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file elephant_agent-1.0.0.dev20260526151829.tar.gz.

File metadata

File hashes

Hashes for elephant_agent-1.0.0.dev20260526151829.tar.gz
Algorithm Hash digest
SHA256 9702ba58262536cf17652e88ce7b7e33b1c5a1687778324db6b411e51c622769
MD5 bf487f67990ec5a5beb12599cf90a516
BLAKE2b-256 b2777bf4b43aec14896aa4c005acd8cd3a54a53e362d772021ca96e024be7d10

See more details on using hashes here.

File details

Details for the file elephant_agent-1.0.0.dev20260526151829-py3-none-any.whl.

File metadata

File hashes

Hashes for elephant_agent-1.0.0.dev20260526151829-py3-none-any.whl
Algorithm Hash digest
SHA256 2d659ad3f861f35ea98b88507e3642c629068dd827b2da070b2b48a19aecf65b
MD5 ef4ee2d45990cdf583f936ef1b024d8b
BLAKE2b-256 6ff90498af4274382cd9e214b0fc0a1ba1885622f36ee0ee61c833bd8b1ddc82

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page