phaibel 4.0.22 → 4.0.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +27 -51
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -4,8 +4,6 @@ An AI-powered personal assistant that manages your tasks, events, notes, goals,
4
4
 
5
5
  Choose from 4 personalities and name your agent to make it truly yours.
6
6
 
7
- > **Requires an API key from [OpenAI](https://platform.openai.com) and/or [Anthropic](https://console.anthropic.com).**
8
-
9
7
  ```
10
8
  ___ __
11
9
  @@@@@@%%%%%%%%%%%%%%%%%##############%%#######%%%%%%%%%%%%%%@@@@@@@@@@@%%#########*+*#+++=:::::::::-
@@ -17,7 +15,7 @@ Choose from 4 personalities and name your agent to make it truly yours.
17
15
  @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%%%%%%#+=+####***+-::........:--::...................:=--=-:::::----:
18
16
  @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%###%*==+*****+=-:.-*%%%%%%%##*-:...................:=---===++**+===
19
17
  @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%#*****=-=++===::=#%@@@@@@@%####%*=:............:::--++---==++***+===
20
- @@@@@@@@@@@@@@%%%%%%%%%%%%%%@%#+==++---==----#@@@@@@%@@@%%##%%%##=..........:---==++-:-==+++++==--
18
+ @@@@@@@@@@@@%%%%%%%%%%%%%%@%#+==++---==----#@@@@@@%@@@%%##%%%##=..........:---==++-:-==+++++==--
21
19
  @@@@@@@@%%%%%%%%%%%%%%%%%%%%%%%#*=--==-:-=--:=@@@@@@@@@@@@@%%##%@%%%*:......::-----=++-:-====+++=---
22
20
  @@@@@%%%%%%%%%%%%%%%%%%%%%#%#%%#+---==-:---:-*@@@@@@@@%#*++====*%%%#*-......-------=++-:-==+++++=---
23
21
  @@@@@@%%%%%%%%%%###############*=---==-:---::*@@@%#***++===-----*##*+-......:---====++-:-===++++=---
@@ -42,55 +40,25 @@ Choose from 4 personalities and name your agent to make it truly yours.
42
40
 
43
41
  ## Quick Start
44
42
 
45
- ### 1. Install
46
-
47
- ```bash
48
- # Install globally
49
- npm install -g phaibel
50
-
51
- # Or build from source
52
- git clone https://github.com/clift-labs/phaibel.git
53
- cd phaibel
54
- npm install
55
- npm run build
56
- npm link
57
- ```
58
-
59
- ### 2. Create a vault
60
-
61
- Navigate to a directory where you want your data stored:
62
-
63
- ```bash
64
- mkdir my-vault && cd my-vault
65
- phaibel init
66
- ```
67
-
68
- This creates a `.vault.md` marker, entity directories (todos, events, notes, etc.), and prompts you to configure an AI provider API key.
43
+ 1. **Install and create a vault**
44
+ ```bash
45
+ npm install -g phaibel
46
+ mkdir my-vault && cd my-vault
47
+ phaibel init
48
+ ```
69
49
 
70
- ### 3. Start the service
50
+ 2. **Configure an API key** (prompted during init)
51
+ > Requires a key from [OpenAI](https://platform.openai.com) and/or [Anthropic](https://console.anthropic.com)
71
52
 
72
- ```bash
73
- phaibel service start
74
- ```
75
-
76
- ### 4. Open the web client
77
-
78
- Visit **http://localhost:3737** in your browser.
53
+ 3. **Open the web client at [http://localhost:3737](http://localhost:3737)**
79
54
 
80
- If this is a new vault, you'll see an onboarding wizard that walks you through:
55
+ 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:
81
56
 
82
- 1. **Personality** — choose how your agent communicates
83
- 2. **Identity** name your agent and introduce yourself
84
- 3. **Profile** optional context about your work, goals, and life
85
-
86
- After onboarding, chat with your agent using natural language:
87
-
88
- ```
89
- remind me to call the dentist tomorrow
90
- what's on my plate today?
91
- create a goal to run a half marathon by June
92
- add a note about the meeting with Sarah
93
- ```
57
+ ```
58
+ remind me to call the dentist tomorrow
59
+ what's on my plate today?
60
+ create a goal to run a half marathon by June
61
+ ```
94
62
 
95
63
  ## Personalities
96
64
 
@@ -103,7 +71,7 @@ add a note about the meeting with Sarah
103
71
 
104
72
  ## CLI Commands
105
73
 
106
- The CLI is an admin toolkit for managing Phaibel. The web client at `http://localhost:3737` is the primary user interface.
74
+ The CLI is an admin toolkit. The web client at `http://localhost:3737` is the primary user interface.
107
75
 
108
76
  Run `phaibel --help` to see all commands:
109
77
 
@@ -115,6 +83,7 @@ Run `phaibel --help` to see all commands:
115
83
  | `phaibel queue status\|pause\|resume\|clear` | Inspect the task queue |
116
84
  | `phaibel index stats\|rebuild\|graph\|neighbors` | Manage the entity relationship graph |
117
85
  | `phaibel cron list\|enable\|disable\|run` | Manage scheduled background jobs |
86
+ | `phaibel calendar add\|remove\|list\|sync` | Manage Google Calendar ICS feeds |
118
87
  | `phaibel feral` | Inspect the Feral CCF flow engine |
119
88
  | `phaibel sync` | Git-based vault sync |
120
89
  | `phaibel setup` | Update your name and preferences |
@@ -160,7 +129,7 @@ When both providers are configured, Phaibel picks the best model for each task:
160
129
 
161
130
  | Capability | What it does | OpenAI default | Anthropic default |
162
131
  |------------|-------------|----------------|-------------------|
163
- | reason | Complex thinking | gpt-4o | claude-opus-4-6 |
132
+ | reason | Complex thinking | gpt-4o | claude-sonnet-4-6 |
164
133
  | chat | Conversation | gpt-4o | claude-sonnet-4-6 |
165
134
  | summarize | Condensing info | gpt-4o-mini | claude-haiku-4-5 |
166
135
  | categorize | Classification | gpt-4o-mini | claude-haiku-4-5 |
@@ -212,11 +181,18 @@ Every entity is a plain `.md` file. Edit them with any text editor, sync with Gi
212
181
 
213
182
  ## Development
214
183
 
184
+ ```bash
185
+ git clone https://github.com/clift-labs/phaibel.git
186
+ cd phaibel
187
+ npm install
188
+ npm run build
189
+ npm link
190
+ ```
191
+
215
192
  ```bash
216
193
  npm run dev # Run with tsx (hot reload)
217
194
  npm test # Run unit tests
218
195
  npm run test:all # Run all tests including integration
219
- npm run build # Compile TypeScript to dist/
220
196
  ```
221
197
 
222
198
  ## Requirements
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "phaibel",
3
- "version": "4.0.22",
3
+ "version": "4.0.24",
4
4
  "description": "AI personal agent that dynamically assembles executable processes from composable code blocks — powered by FeralCCF",
5
5
  "type": "module",
6
6
  "engines": {