How To Use Logseq from Your Terminal

Published: 2024-12-14 14:36

If you're like me, you live in the terminal.

Whether it's managing files, editing code, or checking git status - the command line is home. If there is one thing that slows me down it's switching out of the terminal to take a quick note. I needed a terminal-based tool that brings Logseq journaling to the command line.

lsq

This break in my flow happens so often that I decided to make lsq. lsq solves this by bringing Logseq journaling right to your terminal. Create, edit, and manage journal entries without leaving your command line workflow.

Setup

1. Install lsq:

   go install github.com/jrswab/lsq@latest
           

2. Verify installation:

   lsq -h
           

That's it! lsq automatically detects your Logseq directory and configuration.

Command Examples

Start journaling immediately with:

lsq
        

This opens today's journal in your $EDITOR. Prefer a terminal UI? Use:

lsq -t
        

Custom Directory

Have your Logseq files in a non-standard directory? Maybe in your Documents folder or a different drive?

lsq -d ~/Documents/MyLogseq
        

Date Selection

Open a past or future journal page:

lsq -s 2024-12-24
        

Terminal UI

lsq has a built-in TUI mode that brings Logseq's core functionality right to your terminal.

Features and Shortcuts

• Ctrl+t: Toggle TODO states (DONE, DOING, NOW, LATER, TODO)
• Ctrl+p: Cycle priorities
• Ctrl+f: Search pages and aliases
• tab: Indent line (from anywhere!)
• shift+tab: Unindent line
• Ctrl+s: Save
• Ctrl+c: Exit

Search Example

Press Ctrl+f and type to search. For example:

• Type "meeting" to find all pages with "meeting" in the title
• Type "@john" to find pages aliased to "john"

Task Management

Pro tip: Combine tab with TODO states for rapid task management:

- Draft blog post
            - DONE Outline main points
            - TODO Add code examples
            - LATER Add screenshots
        

User Configuration

lsq uses your existing Logseq configuration in config.edn for some basic information:

{:meta/version 1
         :preferred-format "Markdown"
         :journal/file-name-format "yyyy_MM_dd"}
        

It's Fast

lsq is built in Go for speed and uses the lightning-fast Bubble Tea framework for its TUI. No waiting for Electron to load or web interfaces to render - just pure terminal efficiency.

Get Involved

• Star the project on GitHub
• Report bugs or request features
• Share your terminal journaling workflows

Remember: The best journal entry is the one you actually write. lsq removes the friction of context switching, keeping you in your terminal flow while maintaining your knowledge base.

Happy terminal journaling!