Skip to main content
Gemini CLI gives you Gemini-powered code edits and reasoning straight from the terminal. Pair it with SpecStory to convert every session into reusable Markdown notes.

​
Install SpecStory CLI

Install the SpecStory CLI once to wrap the Gemini CLI and manage your transcripts. 
brew tap specstoryai/tap
brew update
brew install specstory
specstory version
specstory check
Need Linux or WSL binaries or installing manually? Download the archive that matches your OS and architecture (for example SpecStoryCLI_Linux_x86_64.tar.gz or SpecStoryCLI_Darwin_arm64.zip) from the latest release, make them executable, and move them into your PATH.
tar -xzf SpecStoryCLI_Linux_x86_64.tar.gz   # unzip the Darwin archive on macOS
sudo mv specstory /usr/local/bin/
sudo chmod +x /usr/local/bin/specstory
specstory version
Swap the archive name for the asset you downloaded and repeat when upgrading.

​
Run Gemini CLI with auto-save

Launch Gemini CLI through SpecStory to capture a Markdown history in .specstory/history/. 
specstory run gemini
You use Gemini CLI as normal while SpecStory records the entire conversation and context.

​
Sync older Gemini CLI sessions

If you used Gemini CLI before installing SpecStory, retroactively export existing sessions. 
# Convert every stored Gemini CLI session
specstory sync gemini

# Convert a single session by UUID
specstory sync gemini -s <session-uuid>

# Watch the sync progress
specstory sync gemini --console
The resulting Markdown files live under .specstory/history/ with timestamps and metadata for easy sharing.

​
Best practices

  • Segment workstreams: Use Gemini CLI’s commands to start fresh sessions per task so transcripts stay focused.
  • Document custom tooling: Add notes about bespoke scripts or workflows to the Markdown files for teammate handoff.
  • Archive transcripts: Commit .specstory/history/ alongside your code to preserve design intent.

​
Troubleshooting

  • gemin command missing: Confirm installation by running gemini --version outside SpecStory.
  • No Markdown output: Run inside a project directory that contains .specstory/ and allows writing.
  • Sync returns nothing: Ensure Gemini CLI has existing session logs in the current workspace.
  • Need assistance? Contact support@specstory.com or open a ticket on GitHub.