charmcli/skate repository overview

⁠Skate

A personal key-value store. 🛼

Skate is simple and powerful. Use it to save and retrieve anything you’d like—even binary data. It’s fully encrypted, backed up to the cloud (that you can self-host if you want) and can be synced with all your machines.

# Store something (and sync it to the network)
skate set kitty meow

# Fetch something (from the local cache)
skate get kitty

# What’s in the store?
skate list

# Pull down the latest data
skate sync

# Spaces are fine
skate set "kitty litter" "smells great"

# You can store binary data, too
skate set profile-pic < my-cute-pic.jpg
skate get profile-pic > here-it-is.jpg

# Unicode also works, of course
skate set 猫咪 喵
skate get 猫咪

# For more info
skate --help

⁠Installation

Use a package manager:

# macOS or Linux
brew tap charmbracelet/tap && brew install charmbracelet/tap/skate

# Arch Linux (btw)
pacman -S skate

# Nix
nix-env -iA nixpkgs.skate

Or download it:

• Packages⁠ are available in Debian and RPM formats
• Binaries⁠ are available for Linux, macOS, and Windows

Or just install it with go:

go install github.com/charmbracelet/skate@latest

⁠Other Features

⁠Databases

Sometimes you’ll want to separate your data into different databases:

# Database are automatically created on demand
skate set secret-boss-key@work-stuff password123

# Most commands accept a @db argument
skate set "office rumor"@work-stuff "penelope likes marmalade"
skate get "office rumor"@work-stuff
skate list @work-stuff

# Oh no, the boss is coming!
skate reset @work-stuff

⁠Linking

One of the most powerful features of Skate is its ability to link two machines together so they have access to the same data. To link two machines together just run:

skate link

And follow the instructions. Keep in mind that you'll need access to both machines.

⁠Syncing

When you run skate set, data is encrypted and synced to the network. When you get, however, data is loaded from the local cache. To fetch any new data from the server just run skate sync.

⁠Examples

Here are some of our favorite ways to use skate.

⁠Keep secrets out of your scripts

skate set gh_token GITHUB_TOKEN

#!/bin/bash
curl -su "$1:$(skate get gh_token)" \
    https://api.github.com/users/$1 \
    | jq -r '"\(.login) has \(.total_private_repos) private repos"'

⁠Keep passwords in their own database

skate set [email protected] PASSWORD
skate get [email protected]

⁠Use scripts to manage data

#!/bin/bash
skate set "$(date)@bookmarks.db" $1
skate list @bookmarks.db

What do you use skate for? Let us know⁠.

⁠Self-Hosting

Skate is backed by the Charm Cloud. By default it will use the Charm hosted cloud, but it’s incredibly easy to self-host, even if that’s just on your local network. For details, see the Charm docs⁠.

⁠Hey, Developers

Skate is built on charm/kv⁠. If you’d like to build a tool that includes a user key value store, check it out.

⁠Feedback

We’d love to hear your thoughts on this project. Feel free to drop us a note!

• Twitter⁠
• The Fediverse⁠
• Slack⁠

⁠License

MIT⁠

Part of Charm⁠.

Charm热爱开源 • Charm loves open source