thinkrail blog workspace/blog · from main

Introducing ThinkRail

Maciej Gorywoda 4 min read
announcementthinkrail

A Web-Based GUI for Pi Coding Agent

ThinkRail is a web-based graphical interface for the Pi Coding Agent, designed to complement its powerful command-line workflow. Pi’s strength lies in its flexibility: it is a minimal harness that lets you customize extensions and skills, and configure your working environment to fit your exact needs. This power, however, comes at a cost. New users often find themselves spending significant time learning how to navigate Pi, and even experienced users may find the workflow unnecessarily clunky.

We believe ThinkRail can make Pi more accessible without compromising its power. It provides a visual layer on top of Pi, making it easier to onboard and become productive while preserving all of Pi’s depth and extensibility. What’s more, ThinkRail’s integration with Git and GitHub also makes it easier to collaborate on projects in real time.

Great, how can I get it?

Download the stable desktop application for your platform:

For either Linux archive, extract it and run ./installer. Linux desktop builds require Ubuntu 24.04+ or another distribution with glibc 2.38 and the required GTK/WebKitGTK libraries.

Prefer the command line? The CLI-only host remains available for terminal and remote workflows.

macOS/Linux/WSL:

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

Windows — PowerShell:

irm https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.ps1 | iex

Launch the desktop app and choose a Git repository. If you installed the CLI, run thinkrail; your browser will open a new tab prompting you to open your first local project. Every working session operates on a separate Git branch that merges with the original repository only after the work is finished and reviewed.

Before opening the project, you can click the gear icon in the top-right corner to access the Settings panel, where you can configure your LLM providers, GUI appearance, and other settings.

After setup, return to the main screen, open your project, click its entry in the left panel, expand it, and select “Default” to open your default workspace. You can then start a new chat with your AI agent of choice, browse your project’s files, and review any changes the AI agent makes. The GUI also includes a CLI window that you can use to build and test the project.

What’s next?

In the near future, we will publish several short blog posts like this one to discuss ThinkRail’s features and respond to your feedback. Among the features we want to tell you about are:

  • Worktrees: Every workspace in ThinkRail is a real Git worktree: its own branch, its own working directory. This means that if you run several agents in parallel, each one stays on its branch, and the main branch stays clean until you say “merge”.

  • Specification-driven development: Create a collection of documents specifying what your project is about and citing each other (i.e. a “spec graph”), and let the agent treat them as documentation, guidelines, and handrails for thinking.

  • GUI for Pi: ThinkRail wraps around the Pi coding agent and enhances it with a clear, readable AI chat window, Monaco tabs, and a visual way to handle settings and models.

  • Code reviews: Reviewing changes made by the agent in a CLI has always been troublesome. ThinkRail aims to solve this.

How to get involved?

ThinkRail is in the early stages of development, and we are eager to hear your questions and comments. As we continue to build, we want to ensure it addresses the real needs of the Pi community. To help us, we invite you to:

  1. Try ThinkRail: Launch it locally and try it out!
  2. Visit our webpage: The ThinkRail landing page serves a dual purpose: it both describes and demonstrates the product. There you can learn more about each feature and the team behind ThinkRail.
  3. Browse our GitHub repository
  4. Take Our Survey: Share how you use Pi, what frustrates you, and what features you would like to see in ThinkRail. Your input will directly influence our roadmap.
  5. Join Our Discord server: Say “hi” and let us know what you think about ThinkRail.

Happy developing!

ThinkRail is backed by JetBrains, leveraging their expertise in building developer tools that are both powerful and intuitive.