Skribly Agent guide

What you need

Scrollable table

You do not need a separate Node.js install. On macOS and Linux, the app reads the environment from your login shell at startup, so agents installed with nvm, Homebrew or npm -g are found just like in your terminal.

Install it

Scrollable table

Each release also includes SHA256SUMS.txt, so you can verify the files you downloaded.

First launch warnings

The installers are not signed. On macOS, open the app once, then go to System Settings, Privacy & Security, and choose Open Anyway. You can also remove the quarantine flag:

xattr -dr com.apple.quarantine "/Applications/Skribly Agent.app"

On Windows, SmartScreen may show a warning. Choose More info, then Run anyway.

The tour

On first launch, a cursor moves by itself through 15 places in the app. Use the arrow keys to move between steps and Esc to close it. You can replay it from Help.

Add a project

A project is a directory, usually a git repository. Agents, git, audits and skills all work in the selected project.

1. Open the project switcher in the top bar and choose Add project.
2. Pick the directory. The app detects the base branch, checks and development address.
3. Adjust them in Settings, Projects, then Configure, and choose Save.

Removing a project from the list does not touch its files.

Connect a tracker

1. Open Settings, Task trackers, then Add tracker.
2. Choose the tracker and enter its address and token. Open tokens page takes you to where you create one.
3. Choose Save and check. The app encrypts the token and tests the connection.

See addresses and permissions for each tracker

Run your first agent

1. Open Agents and choose New session.
2. Choose an agent. Ones that are not installed are greyed out and show the install command.
3. Choose the project and the working copy: the main one, a worktree or a new worktree.
4. Optionally name the session, pick Terminal or Chat, and type the first message.
5. Choose Run.

The fastest way to start from a tracker: open Tasks, pick a task and choose Start with an agent. The app saves the description, creates a branch and sends the agent a ready prompt.

Pane states

Learn the pane shortcuts

Make your first commit

1. Open Code & git, then the Changes tab.
2. Stage files with the plus button.
3. Choose Suggest. The app writes a message from your repository's history and shows where it came from.
4. Optionally choose Agent to improve the message from the staged diff.
5. Choose Commit, or press ⌘Enter.

The message never gets a Co-Authored-By or Generated with trailer. To clean commits that agents make in the terminal too, choose Hook without AI trailers at the bottom of the Changes tab.

Updates

The app checks for a new version at startup and every four hours, downloads it in the background and installs it on the next restart. You can turn this off in Settings, Updates.