TaCoS Quickstart (5 Minutes)
March 3, 2026 ยท View on GitHub
This guide gets you from install to first useful resume summary quickly, while keeping privacy choices explicit.
Local-Only In 60 Seconds
- Open your project folder in VS Code.
- Open Command Palette and run
TaCoS: Set Privacy Preset. - Choose
Minimal(recommended for first run). - Run
TaCoS: Resume Summary Quick. - Open
TaCoS: Show Last Summaryif the panel is not already visible.
What to expect:
- You get an instant local summary (
Now,Next,Blocked,Restore) with calm status-bar support. Companion HomeincludesIntent (editable)with inlineSaveandReset to inferred.- Deeper Trust/Evidence details stay collapsed until you open them.
- No AI payload is sent in local mode.
Demo Resume Card (Optional, 20 Seconds)
If you want to preview the layout before collecting live context:
- Run
TaCoS: Show Demo Resume Card. - Confirm the top card is clearly labeled as sample onboarding data.
- Select
Show real resume nowwhen you are ready to switch to live local context.
Notes:
- Demo mode is in-memory sample data only.
- Demo mode does not mix with workspace evidence or AI payload sends.
Optional AI In 2 Minutes
Use this only if you want refinement beyond local-only summaries.
- Run
TaCoS: Configure AI Provider. - Choose
VS Code LMorOpenAI (direct API). - If you choose OpenAI, run
TaCoS: Set OpenAI API Key. - Trigger a summary again with
TaCoS: Resume Summary Quick. - Review the generated
TaCoS: Review AI Payloadpreview document. - Choose one consent action:
Send onceAlways allow in this workspaceDo not send
Default safety posture:
tacos.aiIncludeCheckpointNotes = falsetacos.aiIncludeScratchpad = false- AI payload preview shows inclusion flags and redaction summary before send.
- You can open the same payload preview from surfaced guidance (
Companion Home,Why am I seeing this?, andTrust Center).
Control later:
- Run
TaCoS: Revoke AI Payload Consentto require payload review again. - Run
TaCoS: Configure AI Providerand switch back tolocalat any time. - Run
TaCoS: Quiet Now (1 hour)for one-tap temporary suppression. - Run
TaCoS: Configure Summary Quiet Hoursfor recurring quiet windows or temporary quiet presets. - Run
TaCoS: Test Sanitizerto validate local redaction behavior without AI send.
Privacy Presets (Plain Language)
Use TaCoS: Set Privacy Preset to switch.
| Preset | What TaCoS Uses | Typical Use |
|---|---|---|
Minimal | No diff, no terminal history, no debug history, local summary provider | Default safest baseline |
Balanced | Terminal + debug history, no diff, local summary provider | More context without diff capture |
Max Context | Terminal + debug history + diff, local summary provider | Richest local context for hard resumes |
Notes:
- Presets control local collection defaults and set provider back to
local. - In Restricted Mode, risky actions and AI refinement are blocked until workspace trust is granted.
Fast Sanity Check
After setup, confirm:
TaCoSstatus bar entry appears.Companion HomeshowsNow / Next / Blocked / Restore.Companion Homeintent editor updates the summary intent inline and stays scoped to the current partition/context.TaCoS: Export Local Metricswrites.tacos/metrics.csvwhen you want local adoption metrics.
Sticky Notes + Scratchpad (30 Seconds)
- Run
TaCoS: Add Checkpoint Noteand capture one line for future-you. - Run
TaCoS: Open Scratchpadto open the scoped scratchpad in a real editor tab. - Run
TaCoS: Append to Scratchpadto append selected text (or clipboard fallback) with a timestamp divider. - Trigger
TaCoS: Show Resume Brief Nowand confirm the panel shows your notes/scratchpad context.
Expected:
- Checkpoint notes influence resume guidance and standup
Next. - Scratchpad content persists across reload/restart without creating a repo file by default.