thinkrail README

README проекта с github.com/JetBrains/thinkrail. Одним файлом markdown: README.md.

ThinkRail

JetBrains incubator project GitHub stars Discord

ThinkRail is an agentic IDE that gets better every time you use it. With Spec-Driven Development support, it learns your project as you work, becoming more capable and helpful over time.

We built a rich interface around the pi coding agent, isolated work into separate workspaces, and gave the agent durable project knowledge through the spec graph and reusable skills. We are now adding full extension support, so ThinkRail can create the tools it needs based on how you work.

Website: thinkrail.ai · Blog: thinkrail.ai/blog · Discord: thinkrail.ai/discord

⭐ If you find ThinkRail useful, give it a star. It helps others discover it.

Star History Rank GitHub Trending Repository of the Day

ThinkRail workbench: the Projects pane beside the left tool rail listing worktree workspaces and their Settled shelf, a finished pi conversation with its tool steps in the center, the resulting diff beside it, and the Specs tree above the Changes list on the right with their tools on the edge rail *From the left: An isolated workspace, a work session with an AI agent in that workspace, the code change made by the agent, and the spec tree.*

Installation

ThinkRail ships in two forms: a native desktop installer and the self-contained thinkrail CLI. You can install them from out Landing page.

For latest version, see the Releases page.

What you get

The Specs tool, opened from the right edge rail, listing the project's spec tree while the product goal spec is rendered in the editor *The project's spec graph as a tree (on the right), with the spec itself rendered alongside in the center.*

Installation details

Desktop

Download the thinkrail-desktop-* asset for your platform:

There are two update channels: stable and nightly. If the ThinkRail desktop app, you can check them in Settings → Updates: Download → Preparing update → Install & Restart.

Command line

The installer downloads the right binary, verifies its SHA-256 checksum, and puts thinkrail on your PATH.

macOS / Linux (also Windows under Git Bash):

curl -fsSL https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.sh | bash

Windows: the same command works from cmd and PowerShell:

powershell -c "irm https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.ps1 | iex"

Then run thinkrail, optionally with a git repo to open as a project:

thinkrail ~/code/my-repo
Nightly builds, pinned versions, updates, and uninstall The installer takes `--channel stable|nightly` and `--version`; a pinned version must belong to the selected channel:
curl -fsSL https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.sh | bash -s -- --channel nightly
curl -fsSL https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.sh | bash -s -- --channel stable --version 0.3.1
curl -fsSL https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.sh | bash -s -- --channel nightly --version 0.4.0-nightly.2

On Windows the options are environment variables (THINKRAIL_CHANNEL, THINKRAIL_VERSION, THINKRAIL_PREFIX, THINKRAIL_NO_MODIFY_PATH):

$env:THINKRAIL_CHANNEL='nightly'; irm https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.ps1 | iex   # PowerShell
set "THINKRAIL_CHANNEL=stable" && set "THINKRAIL_VERSION=0.3.1" && powershell -c "irm https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.ps1 | iex"   # cmd

If you keep ThinkRail running, it periodically checks for updates and, when it finds one, shows an "Update available" button in the GUI.

thinkrail uninstall removes the executable, the PATH entry the installer added, and the install metadata; it then asks whether to delete your ~/.thinkrail app state (kept by default; --remove-data deletes it, and -y skips the questions).

If you prefer a manual install, download a binary and the SHA256SUMS from the releases page, and verify the checksum. For self-update to work, rename it to thinkrail (thinkrail.exe on Windows) and place it at <prefix>/bin/thinkrail[.exe]; a binary kept under its release filename or elsewhere must be replaced manually or reinstalled with the script.

Platform notes

Platform Desktop CLI
macOS Apple Silicon / Intel DMG signed binary
Windows x64 signed setup executable and app binaries signed .exe
Linux x64 / ARM64 setup tarball, unsigned unsigned

JetBrains signs the Windows CLI, the desktop setup executable, and every executable and DLL the desktop app installs. The macOS CLI is signed but not yet notarized. Signed and notarized desktop DMGs must come from the coordinated JetBrains service pipeline; older published DMGs and locally built packages may still be unsigned and blocked by Gatekeeper. Linux artifacts are unsigned.

Analytics & privacy

ThinkRail apps collect basic usage events: launches, chat creation, message sends, and provider connections. The data is tied to a random installation ID. Usage analytics never include prompts, code, files, credentials, or account identity. Error reports are always sent as well, tied to the same installation ID, so we can fix crashes: they include the error type and code, and where in ThinkRail's own code it happened. They never include error messages, file paths, names, URLs, or anything from your projects or extensions.

Additional product usage is shared only while Share additional usage data is on; the switch is offered during first-run setup (or right after you skip it) and lives in Settings → Privacy. From the command line, thinkrail --no-analytics (or THINKRAIL_NO_ANALYTICS=1) turns additional sharing off for that launch. With additional sharing on, a packaged build may open the ThinkRail blog in your browser once to link your installation to the website visit that brought you here - only where you accepted marketing cookies on the website or no consent is required, and that link expires after 30 days.

Feedback surveys are separate from usage analytics. ThinkRail may invite you to a short survey, and you can also open it from Settings → Feedback. Your answers, including anything you type, are sent to the ThinkRail team only when you press Send, and tied to the same random installation ID, not to your name or account. Please don't include secrets, code, or personal data. To have your answers deleted, email [email protected].

The ThinkRail apps and the ThinkRail website (thinkrail.ai) use PostHog Inc. services for analytics. The website also uses PostHog Surveys to collect feedback after a desktop download and, only if you choose to provide it, your email address, which is used to ask for further feedback and to send product updates. PostHog's privacy policy is at posthog.com/privacy.

Under the hood

ThinkRail is a thin host that runs pi in-process and bridges it to a web UI. pi owns models, skills, compaction, cost, and session state. ThinkRail owns workspace management, the GUI, and the contracts between the engine and the GUI.

goal-and-requirements.md and architecture.md are the product and design specs. ThinkRail is developed spec-first: a SPEC.md sits beside every module, and when a change made by an AI agent moves a boundary or a contract, the spec is updated in the same change.

Developing ThinkRail

You need Bun 1.4.4 (the pinned package manager and runtime), Node.js ≥ 22.23.4 (the in-process pi engine needs ≥ 22.19; the website build and typecheck need ≥ 22.23.4 for Astro 7.4), and an AI provider for agent work.

git clone https://github.com/JetBrains/thinkrail.git
cd thinkrail
bun install
bun run dev                          # host + web client together; Ctrl+C stops both
bun run --filter @thinkrail/cli dev  # browser launcher
bun run build:binary                 # standalone CLI artifact
bun run desktop:dev                  # package and open the Electrobun app
bun run desktop:build                # package without opening it

CONTRIBUTING.md covers the checks, the end-to-end suites, desktop packaging, and the repository layout.

Contributing

Contributions are welcome. See CONTRIBUTING.md. This project and community are governed by the Code of Conduct.

Community

Join us on Discord to ask questions, share what you're building, and talk to the team. Bugs and feature requests go to GitHub issues.

License

Licensed under the Apache License 2.0.

thinkrail (JetBrains/thinkrail)

Ищем в базе…

Что это такое?ThinkRail — это агентная IDE на основе агента для написания кода pi, которая изолирует работу в рабочих пространствах на основе git-worktree и сохраняет долговременные знания о проекте через живые файлы SPEC.md и многократно используемые Agent Skills.
Это самостоятельная IDE или расширение для существующего редактора?Это самостоятельная полноценная IDE — либо нативное настольное приложение, либо CLI, который открывает то же приложение в браузере. В ней есть редактор Monaco, живой вид изменений git, терминалы и чат; всё это встраивает движок pi внутри процесса.
Как установить и запустить?Скачайте подходящий ресурс thinkrail-desktop для вашей ОС (DMG для macOS, ZIP-установщик для Windows, tarball для Linux) или запустите скрипт установки, чтобы добавить CLI thinkrail в PATH, а затем запустите thinkrail, при желании указав путь к репозиторию git.
Что нужно, чтобы начать писать код?Нужен git в PATH и вход в аккаунт у провайдера модели — JetBrains AI или ваши собственные учётные данные провайдера, совместимого с pi, так как у самого ThinkRail своих аккаунтов нет.
Есть ли подводные камни при установке?Сборки настольного приложения для Mac с процессором Intel нет (только Apple Silicon; пользователям Intel придётся собирать CLI из исходников). Артефакты настольного приложения для Linux не подписаны, а CLI для macOS подписан, но пока не прошёл нотаризацию.
Отправляет ли он куда-либо мой код или запросы?Он отслеживает только базовые события использования, например запуски и отправку сообщений, привязанные к случайному идентификатору установки, и никогда не собирает запросы, код, файлы, учётные данные или данные об аккаунте. Дополнительную передачу данных можно отключить флагом --no-analytics.
Что такое «pi» в этом контексте?pi — это базовый движок агента для написания кода, который ThinkRail запускает внутри процесса. Он управляет моделями, навыками, сжатием контекста, расходами и состоянием сессии, а ThinkRail предоставляет вокруг него рабочее пространство, редактор и интерфейс.
Что такое «живые спецификации», которые он ведёт?Живые спецификации — это связанный граф файлов SPEC.md рядом с кодом. Агент читает, ищет и обновляет их с помощью специальных инструментов для спецификаций, поэтому намерения проекта сохраняются между сессиями.
Можно ли использовать уже имеющиеся Agent Skills для других агентов для написания кода?Да — переносимые Agent Skills, которые вы храните для других агентов, читаются на месте. Также доступны встроенные сценарии работы для настройки проекта, обсуждения дизайна и отправки pull request.
Как на самом деле работают изолированные рабочие пространства?После открытия проекта можно создать рабочие пространства как отдельные git worktree, у каждого своя ветка и каталог, так что параллельные сессии агента never не затрагивают основную рабочую копию. Завершённые рабочие пространства архивируются автоматически, как только их pull request влит или они перестают активно использоваться.
Какие есть похожие проекты?claude-code, acryl, Baize, Agentlas-OS, mobilecode, hyperfide-oss, gentle-shell, qwen-code
Автор
JetBrains
Размер
91.3 MB
Звёзды
8.3K
Возраст
4 мес
Коммиты · 90 дней