Skip to content

Commit 19fb1bb

Browse files
author
nocoder26
committed
Document auto-firing concierge: install + cold-start flow
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.
1 parent c2ea73e commit 19fb1bb

1 file changed

Lines changed: 21 additions & 11 deletions

File tree

README.md

Lines changed: 21 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,8 @@ Three slash commands inside Claude Code. Run them **one at a time** — Claude C
133133
/reload-plugins
134134
```
135135

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+
136138
That's it. **No Python, no `pip`, no terminal setup required.** Telos works file-only by default.
137139

138140
> 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
151153

152154
## Start using it
153155

154-
Open a fresh project directory, start Claude, and run **one command**:
156+
Open a fresh project directory and start Claude:
155157

156158
```bash
157159
mkdir my-startup && cd my-startup && claude
158160
```
159161

160-
Then in Claude:
162+
Now type **anything** (e.g., `hi`). The concierge welcome fires automatically:
161163

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:
165167

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.
167172

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`.
169174

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+
```
171180

172181
## Update / re-install
173182

@@ -192,11 +201,12 @@ export TELOS_PITCH_ALWAYS=1 # show pitch even in dirs with package.json/.git/
192201

193202
```
194203
$ mkdir my-startup && cd my-startup && claude
195-
> /telos:start
204+
> hi
196205
197206
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?)
200210
201211
> yes
202212

0 commit comments

Comments
 (0)