Help
How to start, what you need and what to do when something does not work. The apps are not public yet, so this page prepares you for the first release.
Getting started
Install what you need
You need Git and at least one agent, such as Claude Code or Codex. Skribly Agent does not need a separate Node.js install.
Add a project
Choose a folder with a repository. The app detects your stack and your installed agents.
Connect a tracker
Add a Jira, Redmine, GitHub, GitLab or Linear account, or use Skribly Tracker.
Run your first agent
Open a task and start it with an agent, then review the changes before you commit.
Requirements
- System
- macOS 12 or newer, Windows 10 or 11, or Linux x64.
- Git
- Needed for changes, commits and worktrees.
- Agent
- At least one agent command-line tool. The app detects it for you.
Common problems
An agent is not detected
Open Settings, then Agents, and choose Detect again. Check that the agent's folder is in the PATH of your login shell, then restart the app.
macOS says the app cannot be opened
The app has no Apple certificate yet. Open System Settings, then Privacy & Security, and choose Open Anyway.
Windows shows SmartScreen
The installer is not signed yet. Choose More info, then Run anyway.
A tracker returns 401 or 403
The token is wrong or lacks permissions. Create a new one, add it to the account and choose Save and test.
Skills do not download
Check that Git is in your PATH, check your network, and check the address in the skills repository setting.
Glossary
- AI
- Artificial intelligence.
- AI agent
- A program that takes an instruction, then reads code, changes it and runs tools by itself.
- API
- The way programs talk to each other.
- Branch
- A separate line of changes in a Git repository.
- Commit
- A saved set of changes in Git, with a description.
- SEO
- Work that keeps a page easy to find in search engines.
- Tracker
- An app for keeping a project's list of tasks.
- WCAG
- International guidelines for accessible websites.
- Worktree
- A separate copy of the project files, so agents do not get in each other's way.
Still stuck?
Write to us at contact@skribly.pl.