Installation#

To get started with Ragtime OS, follow these steps:

Prerequisites#

  • Git: Ensure you have Git installed.
  • Go: Required for building Ragtime OS components.
  • FUSE: Required for filesystem integration (on macOS, install macfuse).

Clone & Build#

git clone https://github.com/byronellis/ragtime.git
cd ragtime
go build -o ragtime-os cmd/ragtime-os/main.go

Setup#

  1. Initialize the OS:
    ./ragtime-os init
  2. Mount the Filesystem:
    ./ragtime-os mount /mnt/ragtime
  3. Connect Your Agent: Point your agent harness (like Claude Code) to the mounted directory.

Next Steps#