How to use Salt (saltmd/salt.md): 4 use cases

4 use cases

Run a team workspace on your own server

Install one binary and get docs, databases and realtime editing on your own machine.

View prompt

Using the salt.md repo at https://github.com/saltmd/salt.md, install a self-hosted instance on <target-server> using the install.sh one-liner from the README. Report the address the installer prints and confirm that the URL responds in a browser.

Let an AI agent work in your workspace via MCP

Point Claude, Cursor or another MCP client at /mcp so it edits pages and databases.
- REPO saltmd/salt.md
- Claude Code
- Codex
- Cursor
- Gemini CLI
- Work and operations
- Intermediate
View prompt
```
Using the salt.md repo at https://github.com/saltmd/salt.md, connect this MCP client to the /mcp endpoint of <instance-url>. Create a test page titled <page-title> and confirm it appears in the workspace and in the activity log.
```

Move a Notion export or Markdown folder into Salt

Import Markdown, CSV or Notion export files into a self-hosted workspace in one pass.

View prompt

Using the salt.md repo at https://github.com/saltmd/salt.md, import the export at <path-to-export> into the instance at <instance-url> through the workspace import menu. Report how many pages and tables were created and list any that failed.

Load a JSON dataset into a workspace database

Have an agent bulk-import rows from a JSON source without the content passing through it.
- REPO saltmd/salt.md
- Claude Code
- Codex
- Cursor
- Gemini CLI
- Work and operations
- Advanced
View prompt
```
Using the salt.md repo at https://github.com/saltmd/salt.md, create a database in the workspace at <instance-url> and bulk import the JSON file at <path-to-json>. Report the number of rows created and confirm the count matches the source.
```

Quick start with Salt

Check you have what it needs: A Linux, macOS or Windows machine or server to run the binary, or a machine with Docker; A web browser to open the address the installer prints; An MCP-capable client such as Claude, ChatGPT, Codex, Cursor or Gemini CLI, if you want agents to work in the workspace.
Open saltmd/salt.md on GitHub and read the README and license.
Run curl -fsSL https://raw.githubusercontent.com/saltmd/salt.md/main/install.sh | sh on the server (or wget -qO- … | sh if curl is missing).
Note the address the installer prints and open it in a browser.
Alternatively, run docker run -d -p 8420:8420 -v salt-data:/data ghcr.io/saltmd/salt.md:latest if you prefer Docker.
Read the self-hosting guide at https://salt.md/wiki/self-hosting/ for reverse proxies, TLS and backups before exposing it to your team.

These steps come from our top use case, Run a team workspace on your own server, which also has a copy-paste agent prompt.

Use this in your AI agent

Ask your agent

Using the Deduped MCP, get the setup steps for saltmd/salt.md

Add Deduped to Claude Code once

claude mcp add --transport http deduped https://dedupedai.com/mcp

Cursor, ChatGPT, others

Best AI repos for Work and operations

About this repo

Who it is forSmall teams and technical leads who want their docs and databases on their own server and want AI agents to work in them.
Why it is hot178 stars, launched 85 days ago
LanguageTypeScript
Sourcegithub.com/saltmd/salt.md · Back to Hot repos

Requirements

A Linux, macOS or Windows machine or server to run the binary, or a machine with Docker
A web browser to open the address the installer prints
An MCP-capable client such as Claude, ChatGPT, Codex, Cursor or Gemini CLI, if you want agents to work in the workspace
Files to import (Markdown, CSV or a Notion export), if you are migrating content

Add this badge to your README

Maintain Salt? Show readers where to find these use cases.

Markdown

[![Use cases on Deduped](https://dedupedai.com/badge/saltmd/salt.md.svg)](https://dedupedai.com/use-cases/saltmd-salt-md/?utm_source=github&utm_medium=badge&utm_campaign=saltmd-salt.md)

HTML

<a href="https://dedupedai.com/use-cases/saltmd-salt-md/?utm_source=github&amp;utm_medium=badge&amp;utm_campaign=saltmd-salt.md"><img src="https://dedupedai.com/badge/saltmd/salt.md.svg" alt="Use cases on Deduped" height="20"></a>

A static image, no tracking script. About the badge

Questions about Salt

What is Salt?

salt.md is a self-hosted, open-source workspace with docs, databases and realtime editing, plus an MCP server so AI agents work in the same workspace under the same permissions. It is an open-source project on GitHub: https://github.com/saltmd/salt.md.

How do I use Salt?

Run curl -fsSL https://raw.githubusercontent.com/saltmd/salt.md/main/install.sh | sh on the server (or wget -qO- … | sh if curl is missing); then Note the address the installer prints and open it in a browser; Alternatively, run docker run -d -p 8420:8420 -v salt-data:/data ghcr.io/saltmd/salt.md:latest if you prefer Docker. The use cases on this page give the full steps and a copy-paste agent prompt for each job.

Who is Salt for?

Small teams and technical leads who want their docs and databases on their own server and want AI agents to work in them.

What can I do with Salt?

4 use cases so far, for example: Run a team workspace on your own server; Let an AI agent work in your workspace via MCP; Move a Notion export or Markdown folder into Salt. Each has steps and a copy-paste agent prompt.

What do I need to run Salt?

A Linux, macOS or Windows machine or server to run the binary, or a machine with Docker; A web browser to open the address the installer prints; An MCP-capable client such as Claude, ChatGPT, Codex, Cursor or Gemini CLI, if you want agents to work in the workspace; Files to import (Markdown, CSV or a Notion export), if you are migrating content.

What are alternatives to Salt?

Other hot AI repos in Work and operations: n8n Skills, Nocodb, Sim, Agno, n8n MCP.

Is Salt safe to run?

Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.