Skip to content

Commit d782e20

Browse files
committed
AI guide: Route D — agent-mode assistants run makecv in their workspace
Zero-local-setup flow (ChatGPT agent mode etc.): the assistant installs and runs the CLI in its own sandbox and returns the PDF + a cv-content zip (workspaces are ephemeral; the zip is the durable asset). Scopes the privacy claim honestly: makecv makes zero network calls, but cloud assistant routes process CV content on the vendor's infrastructure.
1 parent fee5b5b commit d782e20

1 file changed

Lines changed: 23 additions & 0 deletions

File tree

docs/ai-guide.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ Pick the route that matches the tool you have:
99
| A coding agent (Claude Code, Cursor, Copilot, Codex…) | [Route A](#route-a--coding-agent-lowest-friction) | Lowest — the agent edits files and builds the PDF itself |
1010
| A chat assistant with web access | [Route B](#route-b--chat-assistant-with-web-access) | One paste in, files out |
1111
| A chat assistant without web access | [Route C](#route-c--chat-assistant-self-contained-prompt) | Same, using a self-contained prompt |
12+
| An agent-mode assistant that can run commands (ChatGPT agent mode, …) | [Route D](#route-d--agent-mode-assistant-zero-local-setup) | Zero local setup — the assistant runs makecv in its own workspace |
1213

1314
Whichever route you take, the same two rules apply:
1415

@@ -111,6 +112,28 @@ My CV:
111112

112113
Save the output files into `cv-content/` (after `npx makecv init` for the folder structure and photo placeholder), then `npx makecv build`.
113114

115+
## Route D — agent-mode assistant, zero local setup
116+
117+
If your assistant can execute commands in a workspace (e.g. ChatGPT's agent mode), you don't need anything installed locally — not even Node. Paste:
118+
119+
```text
120+
In your workspace, install Node if needed, then run:
121+
npx makecv init
122+
Replace the example content in cv-content/ with my CV below, following
123+
the schema in cv-content/README.md. Keep every fact truthful to my
124+
input — don't invent anything. Then run:
125+
npx makecv build
126+
and give me BOTH the finished PDF AND a zip of the cv-content folder
127+
as downloads. I need the zip to keep my content for future updates.
128+
129+
My CV:
130+
<paste your old CV / LinkedIn profile text here>
131+
```
132+
133+
The zip matters: agent workspaces are ephemeral, and your `cv-content/` folder is the durable asset. Next time, upload the zip back (or switch to any other route) and ask for the changes you need.
134+
135+
**Privacy note:** makecv itself runs entirely locally and makes zero network calls — but in Route D (and any cloud assistant route) your CV content is processed on the assistant vendor's infrastructure, subject to their terms. If you want your data to never leave your machine, use Route A/C with a local model (e.g. via Ollama) or write the YAML yourself.
136+
114137
---
115138

116139
## Iterating with the assistant

0 commit comments

Comments
 (0)