---
title: "cc-moss: recover Claude Code sessions after a restart"
description: "Track every Claude Code session — busy, waiting or stopped — and bring them all back after a restart, in one click. Free and open source, for macOS and Linux."
canonical: "https://cc-moss.larrykoo.com/"
last-updated: "2026-10-17"
lang: "en"
---

[0.2.0 Now in your menu bar](https://github.com/larrykoo711/cc-moss/releases/latest)

# Every session. Carried on.

A quiet keeper for your Claude Code sessions.  
Restart your Mac, and they’re all back in one click.

[Get cc-moss](https://cc-moss.larrykoo.com/#install)

```sh
brew install larrykoo711/tap/cc-moss
```

Free and open source · macOS 14 or later · Linux in the terminal

Take a look

## All your sessions. One glance.

### Click. It’s all there.

Sorted by project. Start typing to find one, press Return to jump back in.

### ⌘K does the rest.

Send a message. Rename. Leave a note. Bring one back.

### Set up in a minute.

A friendly welcome does the setup for you. No manual required.

### Settings, in plain English.

Open at login, your shortcut, your workspace, your terminal. That’s it.

### Mo, just how you like it.

Click Mo and it hops and talks. Keep it quiet, or let it chat.

Your Mac restarted.

Your terminal crashed.

A window slipped shut.

Nothing was lost.

Always at hand

### Double-tap Control.

From any app, anytime.

Gentle nudges

### Know the moment Claude needs you.

Your setup

### Opens in the terminal you love.

Terminal, Ghostty, iTerm, WezTerm, kitty, Alacritty

-   Private by design
    
    Nothing about you leaves your Mac.
    
-   Two languages
    
    English and Chinese, written by hand.
    
-   Open source
    
    Free, MIT licensed.
    

Meet Mo

## A tiny friend on your desktop.

Mo blinks, follows your cursor, and speaks up only when a session needs you.

Also in the terminal

## Type t. Pick a session.

No app required. Works on Linux, too.

How it compares

## More than one conversation back.

|  | Brings back Claude conversations | Knows which session was where | After a reboot |
| --- | --- | --- | --- |
| `claude --resume` / `--continue` | One at a time, you pick | No | By hand, one by one |
| tmux-resurrect / continuum | No (restores panes and shells) | Panes only | Yes |
| cc-moss | Every interrupted one, in one go | Yes: name, folder, notes | One command |

FAQ

## Questions people ask.

More in the [guide](https://cc-moss.larrykoo.com/guide/).

### What is cc-moss?

cc-moss is an open-source session manager for Claude Code. It remembers each session’s name and folder, and whether it’s busy, waiting for you or stopped. After a restart or a crashed terminal, one command or one click brings every interrupted session back to the same conversation. It runs on macOS and Linux, with a menu bar app on macOS.

### How do I get my sessions back after a restart?

Click Bring them back in the menu bar panel, or run `cc-moss restore` in a terminal. cc-moss reopens each session in its own folder with `claude --resume`, one tmux session each, so you continue the same conversation with the same launch flags.

### How is it different from claude --resume or tmux-resurrect?

`claude --resume` brings back one conversation at a time, and you have to remember which. tmux-resurrect restores panes and shells, not Claude conversations. cc-moss knows where each session was and brings back every interrupted one at once. They work together, too: cc-moss runs inside tmux.

### Does cc-moss send my conversations anywhere?

No. cc-moss keeps a small database on your machine: each session’s id, name and folder, and the first 200 characters of your latest prompt. It goes online in one place: a version check, at most once a day, that carries nothing about you, and you can turn it off.

### What do I need to run it?

macOS or Linux, with Claude Code and tmux. The menu bar app needs macOS 14 or later. Install with Homebrew (`brew install larrykoo711/tap/cc-moss`) or download a prebuilt binary, then run `cc-moss install` to connect it to Claude Code.

### Is it free?

Yes. cc-moss is free and open source under the MIT license; the code, the design notes and every decision are on GitHub.

## Up and running in a minute.

```sh
brew install larrykoo711/tap/cc-moss && cc-moss install
```

1.  Install with Homebrew
2.  Connect Claude Code
3.  Follow the welcome

No Homebrew? [Download the app](https://github.com/larrykoo711/cc-moss/releases/latest) · [Guide](https://cc-moss.larrykoo.com/guide/)