First-run activation menu + bundled dbt sample project
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 38/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Quiet
- Tech stack
- sql, typescript
- Domain
- cli, data-engineering
Research direction
Start by tracing every branch of the /onboard-connect flow and the CLI path used to launch projects. Map where activation prompts and home-directory materialization belong, then verify the acceptance cases: each scan outcome shows the appropriate menu, the bundled project works offline and idempotently, and sample-mode jobs such as dbt build are usable without credentials.
Written by the indexing model from the issue text.
Description
Problem
After the first-run auth + scan-gate flow, a user who dismisses the
scan or lands on an empty environment ends up staring at an
unqualified chat prompt. There's no guided next action, no way to try
Altimate without connecting a real warehouse, and no built-in demo
project to reason against.
What we want
- Guided activation — after every branch of
/onboard-connect, the
agent emits a short JTBD menu (see downstream / review a SQL PR / try
the sample project / describe your own). Warehouse-connected users
get a personalized variant with cost-analysis. - Bundled sample dbt project — a shipped jaffle-shop DuckDB project
the user can launch without any credentials. Idempotent materialize
to the user's home, versioned marker so future CLI upgrades can
detect stale copies.
Acceptance
- Scan-gate "No" leads to a menu, not an empty prompt.
- "Try the sample project" materializes a working dbt project offline.
- Sample-mode follow-up menu points at concrete jobs (
dbt build,
downstream impact, SQL review) that work against the sample. - No credentials required until the user picks "Connect your own".
- Dominant language
- TypeScript
- Stars
- 813
- Forks
- 134
- Avg merge
- 2d 3h
- Merged PRs (30d)
- 65
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from AltimateAI/altimate-code
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
AltimateAI/altimate-code#1359 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
AltimateAI/altimate-code#1323 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 86/100
AltimateAI/altimate-code#1288 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 92/100
AltimateAI/altimate-code#1285 ·
-
privacy: Altimate Base consent dialog no longer discloses persistent per-installation identifier Open
Difficulty 1/5 Under an hour Newbie friendliness 88/100
AltimateAI/altimate-code#1284 ·
All issues in AltimateAI/altimate-code
Similar issues
-
bug(cli): hapi doctor inline-media prints a fabricated B:\ helper-script path in packaged installs Open
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
-
Crush Open
Difficulty 1/5 Under an hour Newbie friendliness 85/100
catppuccin/catppuccin#3125 ·
-
Add a SECURITY.md Open
Difficulty 1/5 Under an hour Newbie friendliness 90/100
ElementsProject/cln-application#167 · 1 comment · 1 reaction ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
Quantco/pnpm-licenses#17 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100