You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
README install section now includes the Cmd+Q cold-start step (required
since /reload-plugins doesn't fire SessionStart). 'Start using it'
section reflects that the concierge welcome fires automatically when
the founder types anything in a fresh dir — no need to type /telos:start
manually. 'Your first 30 minutes' walkthrough updated to match.
Copy file name to clipboardExpand all lines: README.md
+21-11Lines changed: 21 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -133,6 +133,8 @@ Three slash commands inside Claude Code. Run them **one at a time** — Claude C
133
133
/reload-plugins
134
134
```
135
135
136
+
Then **quit Claude Code (Cmd+Q) and reopen.** Cold start is required for the SessionStart hook to register — `/reload-plugins` doesn't fire it.
137
+
136
138
That's it. **No Python, no `pip`, no terminal setup required.** Telos works file-only by default.
137
139
138
140
> Use the full HTTPS URL above — the `nocoder26/telos` shorthand defaults to SSH, which fails unless you have SSH keys configured for GitHub.
@@ -151,23 +153,30 @@ pip install fastmcp
151
153
152
154
## Start using it
153
155
154
-
Open a fresh project directory, start Claude, and run **one command**:
156
+
Open a fresh project directoryand start Claude:
155
157
156
158
```bash
157
159
mkdir my-startup &&cd my-startup && claude
158
160
```
159
161
160
-
Then in Claude:
162
+
Now type **anything** (e.g., `hi`). The concierge welcome fires automatically:
161
163
162
-
```
163
-
/telos:start
164
-
```
164
+
> *"I'm Telos. I'll spend 10 minutes asking three questions, and you'll walk out with a real customer-interview script and a hypothesis you can kill. Sound good? (yes / I already know what I want / what is this?)"*
165
+
166
+
Reply:
165
167
166
-
A 10-minute concierge walks you through capturing your motivation, your hypothesis (with kill criteria), and an interview script you can send today. You exit with a real artifact — `brain/why.md`, `brain/problem.md`, and a script to send to one customer. No fumbling for which skill to run first.
168
+
-**yes** → walks you through `/telos:why` → `/telos:problem` → `/telos:interview` in sequence with one-line context before each step. Auto-creates `brain/`. Exits with a real artifact in 10 minutes.
169
+
-**I already know what I want** → drops out, points you to specific skills (`/telos:why`, `/telos:problem`, etc.). Decision logged so you're never re-pitched in this directory.
170
+
-**what is this?** → one-paragraph explanation, then re-asks.
171
+
-**anything else / change subject** → assumes "no", silenced for this directory forever.
167
172
168
-
If you'd rather skip the walkthrough, run any specific skill (`/telos:why`, `/telos:problem`, `/telos:interview`) directly.
173
+
The pitch fires **once per project** (decision logged to `~/.claude/plugins/telos/decided.txt`) and auto-skips directories that look like existing non-startup projects (have `.git`, `package.json`, `Cargo.toml`, etc.). To bootstrap an existing repo, run `/telos:start` manually, or set `TELOS_PITCH_ALWAYS=1`.
169
174
170
-
The SessionStart hook also offers `/telos:start` automatically when you open a fresh project. The pitch fires **once per project** thanks to a per-project memory file, and auto-skips directories that look like existing non-startup projects (have `.git`, `package.json`, `Cargo.toml`, etc.). To bootstrap an existing repo, run `/telos:start` manually.
175
+
If you ever want to trigger the concierge mid-session (or re-trigger after dismissing it), just run:
176
+
177
+
```
178
+
/telos:start
179
+
```
171
180
172
181
## Update / re-install
173
182
@@ -192,11 +201,12 @@ export TELOS_PITCH_ALWAYS=1 # show pitch even in dirs with package.json/.git/
192
201
193
202
```
194
203
$ mkdir my-startup && cd my-startup && claude
195
-
> /telos:start
204
+
> hi
196
205
197
206
Claude: I'm Telos. I'll spend 10 minutes asking three questions, and
198
-
you'll walk out with a real interview script and a hypothesis
199
-
you can kill. Sound good?
207
+
you'll walk out with a real customer-interview script and a
208
+
hypothesis you can kill. Sound good?
209
+
(yes / I already know what I want / what is this?)
0 commit comments