CLI Usage¶

The naste CLI client sends text to a paste server and returns a URL. It can also fetch pastes with the get subcommand, list pastes with ls, and delete pastes with rm.

Installation¶

GoNix (run without install)Nix (install)NixOS moduleHome Manager

go install github.com/semi710/naste/cmd/naste@latest

echo "hello" | nix run github:semi710/naste#naste --

nix profile install github:semi710/naste#naste

programs.naste-client = {
  enable = true;
  endpoint = "https://paste.semi.sh";
};

Add naste to home.packages and set PASTE_ENDPOINT via sessionVariables.

Fetching Pastes¶

Use the get subcommand to fetch paste content. You can also use curl, but naste get handles auth and endpoints automatically:

# Public paste
naste get hello
# Equivalent: curl https://paste.semi.sh/hello

# Private paste (uses creds from config/env, prompts if missing)
naste get -p hello
# Equivalent: curl -u admin:secret https://paste.semi.sh/private/hello

naste get -p reads credentials from PASTE_USER/PASTE_PASS env vars (or PASTE_USER_FILE/PASTE_PASS_FILE for sops-nix). If no credentials are configured, it prompts for username and password interactively. No need to remember the /private/ URL prefix or pass -u flags manually.

Listing Pastes¶

Use the ls subcommand to list all public and private pastes. Requires admin credentials:

naste ls

Output is grouped by scope, showing slug, size, and creation date:

public:
  hello                    12 bytes  2026-06-30
  mycode                   42 bytes  2026-06-29
private:
  secrets                  15 bytes  2026-06-30

Credentials are read from the same sources as get (env vars, config file, or interactive prompt).

Deleting Pastes¶

Use the rm subcommand to delete a paste. Requires admin credentials:

# Delete a public paste
naste rm old-paste

# Delete a private paste
naste rm -p secret

Delete is scope-specific: a slug that exists in both scopes needs two rm calls (one with -p, one without). Deleting a missing paste is idempotent - it succeeds silently.

Flags¶

Flag	Shorthand	Description
`--slug <name>`	`-s`	Custom slug for the paste
`--private`	`-p`	Create/fetch a private paste (requires auth)
`--force`	`-f`	Force overwrite if slug exists
`--lang <lang>`	`-l`	Language for syntax highlighting (auto-detected from file extension if not set)
`--version`	`-v`	Print version and exit
`--help`	`-h`	Show help

Input Methods¶

Pipe from stdin¶

echo "hello world" | naste
cat file.go | naste
kubectl get pods | naste -s k8s-pods

File argument¶

Pass a file path as a positional argument. Language is auto-detected from the extension.

naste main.go
naste deploy.sh
naste config.yaml

Configuration¶

Config file¶

Create ~/.config/naste/config.toml:

endpoint = "https://paste.semi.sh"
user = "admin"
password = "secret"

Environment variables¶

Environment variables override the config file:

Variable	Description
`PASTE_ENDPOINT`	Server URL (default: `https://paste.semi.sh`)
`PASTE_USER`	Username for private pastes
`PASTE_PASS`	Password for private pastes
`PASTE_USER_FILE`	File containing username (overrides `PASTE_USER`)
`PASTE_PASS_FILE`	File containing password (overrides `PASTE_PASS`)

File-based credentials take precedence over inline env vars. File contents are trimmed of whitespace. Use with sops-nix for secret management.

Language Detection¶

Auto-detected from file extension when using file arguments. Override with --lang.

Extension	Language
`.go`	go
`.py` `.pyw`	python
`.js` `.jsx` `.mjs`	javascript
`.ts` `.tsx`	typescript
`.rs`	rust
`.c` `.h`	c
`.cpp` `.cxx` `.cc` `.hpp`	cpp
`.sh` `.bash`	bash
`.nix`	nix
`.yaml` `.yml`	yaml
...	30+ languages total

Overwrite Behavior¶

If a slug already exists in the same scope (public or private) and --force is not passed, the CLI prompts interactively:

$ naste file.go -s mycode
Slug 'mycode' exists. Override? [y/N]

The same slug can exist independently in both public and private scopes. The prompt reads from /dev/tty (not stdin), so it works even when piping content.

Exit Codes¶

Code	Meaning
0	Success
1	Error (network, file read, server rejection)

Examples¶

# Quick paste
echo "hello" | naste

# Named paste with language
cat script.sh | naste -s deploy -l bash

# Private paste
cat secrets.env | naste -p -s secrets

# Overwrite existing
naste updated.go -f -s mycode

# Pipe kubectl output
kubectl get pods -o yaml | naste -s k8s-debug

# Fetch a public paste
naste get hello

# Fetch a private paste
naste get -p hello

# List all pastes
naste ls

# Delete a public paste
naste rm old-paste

# Delete a private paste
naste rm -p secret