Phaibel

An AI-powered personal assistant that manages your tasks, events, notes, goals, people, and more — all stored as plain Markdown files in a local "vault" folder.

Choose from 4 personalities and name your agent to make it truly yours.

  ____  _           _ _          _
 |  _ \| |__   __ _(_) |__   ___| |
 | |_) | '_ \ / _` | | '_ \ / _ \ |
 |  __/| | | | (_| | | |_) |  __/ |
 |_|   |_| |_|\__,_|_|_.__/ \___|_|

 Your Intelligent Personal Assistant

 ┌─────────────────────────────────────────────┐
 │  "remind me to call the dentist tomorrow"   │
 └──────────────────┬──────────────────────────┘
                    │
                    ▼
 ┌──────────┐  ┌──────────┐  ┌──────────┐
 │ Classify │─▶│ Create   │─▶│ Set Due  │
 │ Request  │  │ Task     │  │ Date     │
 └──────────┘  └──────────┘  └────┬─────┘
                                  │
                    ┌─────────────┘
                    ▼
 ┌──────────┐  ┌──────────┐
 │ Link to  │─▶│ Respond  │
 │ Calendar │  │ to User  │
 └──────────┘  └──────────┘

 Every request builds a unique process graph.

Quick Start

1. Install and create a vault

   npm install -g phaibel
   mkdir my-vault && cd my-vault
   phaibel init

2. Configure an API key (prompted during init)

   Requires a key from OpenAI and/or Anthropic

3. Open the web client at http://localhost:3737

   The service starts automatically after init. On first visit you'll choose a personality, name your agent, and optionally fill in some context about yourself. Then just start chatting:

   remind me to call the dentist tomorrow
   what's on my plate today?
   create a goal to run a half marathon by June
   

Personalities

Personality	Style
British Butler	Formal, composed, measured. "Very good, sir."
Rock Star	High-energy, irreverent, enthusiastic. "Let's shred this to-do list!"
Executive Assistant	Professional, crisp, efficient. "Done. Next item on your agenda."
Friend	Warm, casual, supportive peer. "Hey! I took care of that for you."

CLI Commands

The CLI is an admin toolkit. The web client at http://localhost:3737 is the primary user interface.

Run phaibel --help to see all commands:

Command	Description
phaibel init	Create a new vault in the current directory
phaibel config	Manage API keys and LLM provider settings
phaibel service start|stop|restart|status	Manage the background daemon
phaibel queue status|pause|resume|clear	Inspect the task queue
phaibel index stats|rebuild|graph|neighbors	Manage the entity relationship graph
phaibel cron list|enable|disable|run	Manage scheduled background jobs
phaibel calendar add|remove|list|sync	Manage Google Calendar ICS feeds
phaibel feral	Inspect the Feral CCF flow engine
phaibel sync	Git-based vault sync
phaibel setup	Update your name and preferences
phaibel type list|add|edit|remove	Manage entity type schemas
phaibel entity <type> [action]	CRUD for any entity type
phaibel skill	Manage MCP skill servers
phaibel tool <name> [input]	Run a registered tool directly
phaibel tools	List all available tools

Content Types

Type	Description
todo	Tasks with priority, status, and due dates
event	Calendar events with start/end times and locations
note	Freeform notes
todont	Things you're deliberately not doing

Your agent creates new content types as needed — just ask it to track something new.

How It Works

Phaibel writes a unique software process for every request. Instead of following rigid workflows, it dynamically assembles a process graph tailored to what you asked for.

This is powered by Feral CCF (Catalog-Code Framework):

• NodeCode — reusable logic blocks (e.g., "query todos", "format as markdown", "call LLM")
• CatalogNodes — configured instances with default settings
• ProcessNodes — nodes wired together into a directed graph for a specific request

The web UI visualizes the process created for each action so you can see exactly what happened.

BYOK (Bring Your Own Key)

Your keys are stored locally in ~/.phaibel/secrets.json and never leave your machine.

phaibel config add-provider openai
phaibel config add-provider anthropic

When both providers are configured, Phaibel picks the best model for each task:

Capability	What it does	OpenAI default	Anthropic default
reason	Complex thinking	gpt-4o	claude-sonnet-4-6
chat	Conversation	gpt-4o	claude-sonnet-4-6
summarize	Condensing info	gpt-4o-mini	claude-haiku-4-5
categorize	Classification	gpt-4o-mini	claude-haiku-4-5
format	Text formatting	gpt-4o-mini	claude-haiku-4-5
embed	Vector embeddings	text-embedding-3-small	(not supported)

Override any mapping:

phaibel config set-capability reason anthropic claude-sonnet-4-6
phaibel config reset-capability reason

Where Things Live

~/.phaibel/
  secrets.json         # API keys (never committed)
  phaibel.pid          # Daemon PID
  phaibel.sock         # Unix socket

your-vault/
  .vault.md            # Vault root context (read by the LLM)
  .state.json          # User profile (name, personality, agent name)
  .phaibel/            # Vault-scoped config
    config.json        # LLM capability overrides
    entity-types.json  # Entity type definitions
    logs/              # Chat session logs
    processes/         # Saved Feral processes
  todos/
  events/
  notes/
  goals/
  people/
  recurrences/
  todonts/
  inbox/

Every entity is a plain .md file. Edit them with any text editor, sync with Git, or back up however you like.

Environment Variables

Variable	Description
PHAIBEL_VAULT	Override vault root path
PHAIBEL_SERVICE=1	Internal: marks the process as the daemon
PHAIBEL_DEBUG=1	Enable verbose debug output

Development

git clone https://github.com/clift-labs/phaibel.git
cd phaibel
npm install
npm run build
npm link

npm run dev          # Run with tsx (hot reload)
npm test             # Run unit tests
npm run test:all     # Run all tests including integration

Requirements

• Node.js >= 18
• An API key from OpenAI and/or Anthropic

License

MIT © Clift Labs