Skip to content

docs: reposition ThinkRail as the agentic IDE that gets better with use - #643

Merged
Rinat S (rsolmano) merged 1 commit into
mainfrom
update-thinkrail-wording
Oct 5, 2026
Merged

Rinat S (rsolmano) merged 1 commit into
mainfrom
update-thinkrail-wording

Conversation

@rsolmano

Copy link
Copy Markdown
Collaborator

Problem

ThinkRail still described itself as a "desktop-and-mobile client" (README, AGENTS.md, goal spec, landing-page chat demo) or a "worktree IDE" (landing page title/tagline, CLI startup banner). The recent blog posts already moved away from the GUI/client framing, and the new positioning is: ThinkRail is the agentic IDE that gets better every time you use it — learning your project through living specs today, and building its own capabilities tomorrow.

Approach

Adopt the new positioning in the product's primary self-descriptions only. The README carries the full statement (including the upcoming extension-support plans); goal-and-requirements.md and AGENTS.md take the present-tense part only, since the goal spec holds no roadmap. The thin-host / pi-owns-state description stays, because the agent context and specs depend on it.

Intentionally unchanged: published blog posts, and the /vibecoding/, /agentic-development/, /agentic-ide/ routes, which run a deliberate control-vs-compounding wording test (/agentic-ide/ already uses this wording).

Changes

  • README.md: new two-paragraph positioning lead; the old thin-host sentence follows as "Under the hood…"; "ThinkRail is a Worktree IDE:" → "Every workspace is a git worktree:".
  • AGENTS.md, goal-and-requirements.md: "desktop-and-mobile client" → "the agentic IDE that gets better every time you use it".
  • apps/website/src/pages/index.astro: <title>, og:title, hero tagline, and chat-demo answer use the new wording.
  • packages/shared/src/startupMark.ts: CLI banner "worktree IDE for pi" → "agentic IDE for pi"; the pinned output hash in its test is updated to match.

Screenshots

Copy-only change: landing-page tagline/title text and one CLI banner line; no layout or styling changes.

Related issues

None.

Checklist

  • Fast gates pass: bun run lint, bun run typecheck, bun run test
  • E2E suite passes for app-affecting changes (bun run e2e, or bun run e2e:full when touching agent behavior) — not run; copy-only change
  • Before/after screenshots are included for frontend changes, or marked not applicable — copy-only, no screenshots attached
  • Relevant SPEC.md / top-level specs updated to reflect any boundary, contract, or behavior change
  • I have read the Contributing guide and agree to the Code of Conduct

Testing

  • bun test packages/shared/src/startupMark.test.ts → 7 pass
  • cd apps/website && bun run build (astro check, build, validateBuild) → 11 pages built, validation passed
  • bun run lint → clean
  • bun run typecheck (pre-commit) → 18/18 tasks successful
  • bun run test → 18/18 tasks successful, 0 fail

@github-actions

github-actions Bot commented Oct 5, 2026 •

Copy link
Copy Markdown

🌐 Website preview

Preview retired when this pull request closed.

@jetbrains-air jetbrains-air Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved — ready to merge.

@rsolmano
Rinat S (rsolmano) added this pull request to the merge queue Oct 5, 2026
Merged via the queue into main with commit 18b9177 Oct 5, 2026
12 of 16 checks passed
@rsolmano
Rinat S (rsolmano) deleted the update-thinkrail-wording branch October 5, 2026 22:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant