Command Line Tool

The command line tool lets you manage your projects and skills from the terminal — a scriptable complement to the Studio app. Use it to bootstrap projects, add documents and skills, and curate your local AI projects.

Installation

The command line tool is installed directly from the Studio app — there's no separate download or script to run.

Here are three simple steps to do so:

1. Open the Studio app and go to Settings.
2. Find the Command Line Tool section.
3. Click Install to add the shell command to your path.

Once installed, Settings shows the install location (for example, ~/.local/bin/slp) and an Uninstall button to remove it.

Open a new terminal after installing, then run slp --version to verify:

slp --version

Usage

To see the available commands, run slp --help:

usage: slp [-h] [--version] [--resume CONVERSATION_ID] [-C PATH]
               {run,status,agent,token,skill,mcp,project} ...

AI Agent harness for extracting information and creating new content

positional arguments:
  {run,status,agent,token,skill,mcp,project}
                        Available commands
    run                 Start interactive chat session
    status              Show project status
    agent               Agent management commands (start/stop/status/restart)
    token               Manage your developer token
    skill               Manage skills for the active project
    mcp                 Manage MCP servers for the active project
    project             List, current, or switch the current project

options:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  --resume CONVERSATION_ID
                        Resume a previous conversation by session ID
  -C PATH, --path PATH  Working directory to use (defaults to ~/smartloop or
                        ~/smartloop/<project>) 

Managing projects

Your projects live inside the ~/smartloop/<slug> directory, and this is where skills and documents are copied. Use the project command to list, switch, or inspect them:

slp project              # list projects and show the current one
slp project switch <slug> # switch the active project
slp status               # show status for the active project

Because each project is a directory, you can write scripts that create a project, drop in documents, and wire up skills to bootstrap a repeatable setup.

Managing skills

Skills give your project specialized capabilities — creating events, tickets, connecting external systems, or summarizing a blog post. Manage them for the active project with the skill command:

slp skill                # list skills for the active project
slp skill add <name>     # add a skill
slp skill remove <name>  # remove a skill

Managing MCP servers

Use the CLI to register MCP servers for the active project. For example, if you have uvx installed on your machine, you can register a local MCP server:

slp mcp add uvx yahoo-finance-mcp

note

If your system does not have uv installed, you can install it from https://docs.astral.sh/uv/.

You will need to restart the agent for the changes to take effect.

Requirements

Requirement	Description
OS	macOS (Apple Silicon), Linux (x86_64), or Windows (x86_64)
GPU	Vulkan-capable GPU (NVIDIA, AMD, or Intel) on Linux/Windows, Metal on macOS — optional, defaults to CPU