README.md

Notion Sh

Organize your shell scripts in Notion and run your scripts from anywhere.

Table of Content

• Getting Started
• Command Structure
• Usage
• Commands

Getting Started

1. Create a Notion Developer Integration here
   • Save the token somewhere safe, will use it in step 5
2. Create a Notion page notion-sh (spelling must be same)
3. Create child pages inside notion-sh
   • the name of the child page will be the shell command name
   • include alphabetical characters only, like echo
4. Add code blocks for your shell scripts
5. NOTION_TOKEN=... npx notionsh run
6. 🎉

Command Structure

Under the notion-sh page, all child pages are executable commands. Grouping commands into categories are also avaliable.

In the above example, npx notionsh run will list 4 commands:

$ npx notionsh run

✔ Loading scripts from your Notion pages...
? Execute -> echo
echo
command
command subcommand
command subcommand test

Usage

$ npx notionsh run
✔ Loading scripts from your Notion pages...

Select a script to execute:
- xxx
- xxx
...

# Or run a command directly
$ npx notionsh run COMMAND
...

Commands

• notionsh run

notionsh run

Fetch your script from Notion and execute it.

USAGE
  $ notionsh run
  $ notionsh run COMMAND