How To Use Logseq from Your Terminal

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

Install lsq:
```
go install github.com/jrswab/lsq@latest
```
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! 🚀