clim8

README

Control Eight Sleep via CLI

Why? 🤔

Oh, I think you know why 😏

Getting Started

Install

go install github.com/blacktop/clim8@latest

Or via homebrew

brew install blacktop/tap/clim8

Or download the latest release

Running

❱ clim8 --help

Eight Sleep CLI

Usage:
  clim8 [command]

Available Commands:
  daemon      Run Eight Sleep scheduler daemon
  feats       Dump release features
  help        Help about any command
  info        Show Eight Sleep Info
  off         Turn off Eight Sleep Pod
  on          Turn on Eight Sleep Pod
  status      Show Eight Sleep status
  temp        Set the temperature of Eight Sleep Pod
  tracks      List audio tracks
  version     Show version number

Flags:
  -e, --email string      Email address
  -h, --help              help for clim8
  -p, --password string   Password
  -V, --verbose           Enable verbose debug logging

Use "clim8 [command] --help" for more information about a command.

Config

Set your config ~/.config/clim8/config.yaml

# Your Eight Sleep credentials
email: your@email.com
password: your-password

# Schedule for automated control (optional)
schedule:
  - time: "22:00"    # 10:00 PM - Turn on
    action: "on"
  - time: "22:15"    # 10:15 PM - Set temperature  
    action: "temp"
    temperature: "68F"
  - time: "01:00"    # 1:00 AM - Lower temp for deep sleep
    action: "temp"
    temperature: "65F"
  - time: "06:00"    # 6:00 AM - Turn off
    action: "off"

Manual Commands

You can also control your Eight Sleep pod manually:

# Turn on the pod
clim8 on

# Set temperature (turns on automatically)
clim8 temp 68F

# Turn off the pod
clim8 off

# Check status
clim8 status

Daemon Scheduler

The daemon command runs a background scheduler that automatically controls your Eight Sleep pod based on your configured schedule.

# Run daemon manually
clim8 daemon

# Test your schedule without executing actions
clim8 daemon --dry-run

# Install as system service via homebrew
brew services start blacktop/tap/clim8

The daemon will:

• Execute actions at scheduled times throughout the night
• Automatically restart if it crashes
• Log all activity to /usr/local/var/log/clim8.log
• Run continuously in the background

📖 Full daemon documentation and examples →

License

MIT Copyright (c) 2025 blacktop

Documentation

Overview

Copyright © 2025 blacktop

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.