Notion + Fabric CLI

An unofficial simple CLI for combining the use of notion and fabric.

What is this?

A tool to help you generate notes, summaries, and wisdom from web pages and youtube content, and drop those notes right into notion with a single CLI command. Fabric comes with an extensive set of prompts and utilities to help you generate the data you need. This CLI is designed to make it easier to generate the data and drop it into notion.

Installation

This script heavily relies on fabric prompts and utilities. Install and configure fabric before continuing.

# copy the .env.example file to .env
cp .env.example .env

You'll need to create a new integration in Notion to get a token. You can do this by going to Notion's My Integrations page and creating a new integration. Once you have created the integration copy the Internal Integration Secret and paste it into the .env file under "NOTION_TOKEN". After creating the integration, you'll need to share the page you want to add notes to with the integration. On the desired page click the "..." button in the top right corner, then click "Connect To" and search for the integration you created.

The easiest way to run this is directly from the repo directory.

# install dependencies (first time only)
pnpm i

# run the CLI
pnpm start <fanotion command>

# Summarize a YouTube video
pnpm start yt-summary https://www.youtube.com/watch?v=tl_GXsRKXtQ

# Summarize a web page
pnpm start page-summary https://github.com/CuriouslyCory/fanotion/blob/main/README.md

Alternatively you can build the CLI and install it globally, but you'll need to add the .env variables to your .bashrc or .zshrc file.

npm

npm install
npm run build
npm install -g .

pnpm

pnpm install
pnpm run build
pnpm link --global

Note

2024.06.05: I'm working on configuring for publishing to npm to streamline the installation process.

Commands

fanotion store-note

Stores a new note in Notion.

Usage

fanotion store-note [options]

Options

• -n, --name <name>: Name of the note (default: "Untitled Note").
• -c, --content <content>: Note content if not piped.

Examples

• Store a note with a name and content provided via command line:

  fanotion store-note -n "Meeting Notes" -c "Notes from today's meeting..."

• Store a note with content piped from another command:

  echo "Content from another command" | fanotion store-note -n "Piped Note"

• Store a note with content piped from fabric:

  yt --transcript https://youtu.be/MQmfSBdIfno?si=gf50RUHYXdU4qfS2 | fabric -p extract_wisdom | fanotion store-note -n "Wisdom: Function Calling with Opensource LLMs"

fanotion yt-summary <uri>

Creates a page in Notion with a summary of a YouTube video.

Usage

fanotion yt-summary [options] <uri>

Arguments

• <uri>: The URL of the YouTube video to summarize.

Options

• -m, --model <model>: The model to use for summarization (default: "gpt-4o").`

Examples

• Create a summary page for a YouTube video:

  fanotion yt-summary https://www.youtube.com/live/GxnaWre7N4Y?si=_TPX6Iir_aqQ6WO_

fanotion page-summary <uri>

Creates a page in Notion with a summary of a YouTube video.

Usage

fanotion page-summary [options] <uri>

Arguments

• <uri>: The URL of the YouTube video to summarize.

Options

• -m, --model <model>: The model to use for summarization (default: "gpt-4o").`

Examples

• Create a summary page for a web url:

  fanotion page-summary https://github.com/danielmiessler/fabric/blob/main/README.md

Planned Features

• (yt-summary) Summarize and generate notes from YouTube videos, and store them in Notion.
• (page-summary) Summarize and generate notes from web pages, and store them in Notion.
• (store-note) Create a page in notion with specific content.
• Publish to NPM for quick install.
• Add setup command.
• Add support for storing notes in different pages.
• Add auto categorization tool to help organize notes.
• Add prompt suggestion to automatically find the best tool for the job.
• Add support for storing notes in different databases.
• Better notion markdown formatting.

Troubleshoooting

• If you're on Ubuntu > 23 and get the following error: "Error: Failed to launch the browser process!" try adding the following to your .bashrc or .zshrc file per chromium official docs:

export CHROME_DEVEL_SANDBOX=/opt/google/chrome/chrome-sandbox

Known Issues

• The notion API has a 2000 character limit for the content of a page. I've added data chunking to help with this, but it can mes up formatting and other display issues.