# JotSpot CLI Examples

JotSpot can be used directly from the terminal to create and manage shareable Markdown notes.

This page was written and updated **entirely via the CLI**.

CLI docs: https://jotspot.io/cli

---

## Create a jot from text

```bash
curl -X POST https://jotspot.io/api/v1/jots/text \
     -d "Hello from the terminal"
```

---

## Create a jot from a file

```bash
curl -X POST https://jotspot.io/api/v1/jots/text \
     --data-binary @notes.md
```

---

## Pipe text into a jot

```bash
echo "Quick jot from bash" | \
curl -X POST https://jotspot.io/api/v1/jots/text \
     --data-binary @-
```

---

## Save command output to a jot

```bash
uptime | curl -X POST https://jotspot.io/api/v1/jots/text --data-binary @-
```

Example use cases:

- share logs
- share notes
- quick debugging output
- paste CLI results to a link

---

## Fetch raw markdown

Every jot can be fetched as raw text.

```bash
curl https://jotspot.io/j/<id>.txt
```

or

```bash
curl https://jotspot.io/j/<id>.md
```

---

## Update a jot via CLI

```bash
curl -H "Authorization: Bearer YOUR_API_KEY" \
     -X PATCH https://jotspot.io/api/v1/jots/<id>/text \
     --data-binary @updated.md
```

---

## Shell scripting example

Create a jot and extract the URL:

```bash
URL=$(curl -s -X POST https://jotspot.io/api/v1/jots/text \
      --data-binary @notes.md | jq -r .url)

echo "Jot created: $URL"
```

---

## Why JotSpot CLI exists

Sometimes you just want to:

- dump some text
- share a quick note
- paste command output
- share logs with a link

JotSpot makes that a single command.

---

Browser editor:

https://jotspot.io

CLI documentation:

https://jotspot.io/cli