Install BackMark

Get BackMark installed and running in minutes.

Quick Install

$ npm install -g @grazulex/backmark

Installs BackMark globally on your system

Prerequisites

System Requirements

  • Node.js: Version 18.0.0 or higher
  • npm: Version 8.0.0 or higher
  • Operating System: Linux, macOS, or Windows
  • Disk Space: ~50MB for installation

Check Your System

$ node --version
v18.17.0
 
$ npm --version
9.6.7

Don't have Node.js?

Download and install from nodejs.org (LTS version recommended)

Installation Methods

Method 1: Global Installation (Recommended)

Install BackMark globally to use it from any directory:

$ npm install -g @grazulex/backmark
added 87 packages in 5s
 
$ backmark --version
0.8.0

Benefits:

  • ✅ Available system-wide
  • ✅ Simple backmark command
  • ✅ One-time installation

Method 2: Using npx (No Installation)

Run BackMark without installing:

$ npx @grazulex/backmark init "My Project"
$ npx @grazulex/backmark task create "Task title"

Benefits:

  • ✅ No global installation
  • ✅ Always uses latest version
  • ✅ Good for trying BackMark

Note: Slightly slower as it downloads on each use.

Method 3: Development Installation

For contributors or those wanting to modify BackMark:

$ git clone https://github.com/Grazulex/backmark.git
$ cd backmark
$ npm install
$ npm run build
$ npm link

Benefits:

  • ✅ Latest development features
  • ✅ Ability to contribute
  • ✅ Local modifications

Verify Installation

After installation, verify BackMark is working correctly:

$ backmark --version
0.8.0
 
$ backmark --help
Usage: backmark [options] [command] Markdown-native task management CLI Options: -V, --version output the version number -h, --help display help for command Commands: init Initialize BackMark task Task management board Kanban board search Search tasks config Configuration overview Project overview help [command] display help for command

✅ If you see the version number and help output, BackMark is installed correctly!

Troubleshooting

Command not found: backmark

If you get "command not found" after global installation:

Solution 1: Check npm global bin path

$ npm config get prefix
/usr/local

Add the bin directory to your PATH:

# For bash (~/.bashrc or ~/.bash_profile)
export PATH="$PATH:/usr/local/bin"

# For zsh (~/.zshrc)
export PATH="$PATH:/usr/local/bin"

Solution 2: Use npx instead

npx @grazulex/backmark [command]

Permission denied (EACCES)

If you get permission errors during installation:

Solution: Use a Node version manager

Recommended: Use nvm (Node Version Manager)

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Install Node.js
nvm install --lts

# Install BackMark
npm install -g @grazulex/backmark

Alternative: Use sudo npm install -g (not recommended)

Old version of BackMark

To update to the latest version:

$ npm update -g @grazulex/backmark
updated 1 package in 3s

Need More Help?

If you're still experiencing issues:

Next Steps

1. Initialize Project

backmark init "My Project"

Create your first BackMark project

2. Create a Task

backmark task create "First task"

Add your first task

3. View Board

backmark board show

See your Kanban board

Useful Links