SHIPIT by Dzhura · Guides
SHIPIT guides
Short step-by-step guides. Each one shows a live frame from SHIPIT and where to click, and the text beside it explains what happens.
Opening SHIPIT for the first time? Start with Getting started.
Nothing found. Try another word or clear the level filter.
Getting started
Install, first launch and connecting your agents.
- Install SHIPIT and open it for the first timeIn a few minutes SHIPIT sits in Applications and opens a short setup. You need a Mac with macOS 14 or later.4 minEveryone5 steps
- First launch: setup in 5 stepsFive short steps, after which SHIPIT knows your level, your language and the rules for agents, and you have a first project under way.4 minEveryone6 steps
- Levels and tabs: Beginner, Intermediate, ProThe level decides how much SHIPIT shows at once. Nothing is locked: the level and the tabs change any time.3 minEveryone6 steps
- A tour of the SHIPIT windowA short tour of the window: where to look to start something, watch agents work and find Settings.3 minEveryone6 steps
- Privacy and access: what SHIPIT sees and what agents may doYour work stays yours. Here is what SHIPIT sends, how to set the rules for agents and why macOS asks about folder access.4 minEveryone6 steps
- Connect Claude CodeIn a few minutes Claude Code is on your Mac and runs on the Claude plan you already have. You do not need a terminal.3 minEveryone6 steps
- Connect CodexCodex sets up the same way as Claude Code: one button to install, one to sign in. It runs on the ChatGPT plan you already have.3 minEveryone6 steps
- Language and themeSHIPIT speaks English or Ukrainian and has two dark themes and one light theme. Each one changes with a single click.2 minEveryone5 steps
- Updating SHIPITSHIPIT checks for updates by itself and installs nothing without you. A new build waits in the sidebar until you click it.2 minEveryone5 steps
- Your Dzhura account and your MacsOne Dzhura account works for the website and for SHIPIT. Sign in and SHIPIT knows your plan and name on each of your Macs.2 minEveryone5 steps
Agent
The Agent tab: giving tasks to agents and keeping an eye on the work.
- The Agent tab at a glanceIn three minutes you will know how the Agent tab is laid out: who is on the team, where the chats are and where to type a task.3 minBeginner5 steps
- Your first task for an agentYou will create an agent, give it a folder and send its first task. It takes a few minutes.4 minBeginner7 steps
- Hire a teammateThe lead hires new teammates only when you ask, with one confirmation. Both ways are here: through the lead and by hand.4 minIntermediate6 steps
- Run several agents at onceBy default SHIPIT runs one agent turn at a time. Here you turn on parallel work and set a cap.3 minIntermediate6 steps
- Handoffs and the message queueWrite to an agent even while it works: your messages wait in a queue. To give a task to another teammate, hand it off with @.4 minIntermediate6 steps
- Approvals and Ask before actingYou decide what an agent does on its own and what waits for your yes. Here is where to set it.3 minEveryone5 steps
- Models and effortYou can set model and effort per chat, per teammate and as defaults. What each model is good at is explained on the Models page.3 minEveryone4 steps
- Usage and limitsThe Dashboard shows how much is left in each subscription window and when it resets, so you do not hit a limit mid-task.3 minEveryone6 steps
- Attachments and contextShow the agent what to work with: a file, an image, a folder or another conversation. It all goes through + in the field.3 minIntermediate6 steps
Code
The Code tab: projects, panes, sessions and changes.
- Workspaces and projectsBy the end you have a workspace with panes for one project, and you know where to find it.4 minEveryone6 steps
- The New pane menuOne menu opens any pane: a terminal, a coding agent or a browser. You see where it lands before you click.3 minEveryone6 steps
- Pane layoutsSeveral panes on one screen can be laid out the way you like, and put back in order just as quickly.4 minEveryone6 steps
- The Claude Code paneClaude Code works in your project folder: it reads code, edits files and runs commands. You steer it from the field at the bottom of the pane.5 minEveryone6 steps
- The Codex paneCodex is a coding agent from OpenAI. You describe the task, and it works in the project folder.4 minEveryone6 steps
- The browser paneA browser pane shows a page next to the agent and the terminal. Handy for looking at a site you have just built.3 minIntermediate5 steps
- Pane settingsEvery pane has its own settings: what runs in it, in which folder and with which model. Changes take effect after the pane restarts.4 minIntermediate6 steps
- Sessions: bring terminals back after a relaunchA closed terminal does not disappear. After a relaunch SHIPIT asks what to bring back, and the rest waits in Sessions.4 minEveryone6 steps
- Sleeping panes: free the Mac, keep the conversationSleep stops the agent's process, but the pane and the conversation stay where they are. One button brings the agent back to the same conversation.3 minEveryone5 steps
- Bookmarks: a workspace the way you left itA bookmark remembers a workspace: panes, layout, colour and conversations. It keeps working even after the workspace itself is closed.3 minEveryone5 steps
- Changes and Git: what the agent actually changedThe Git panel shows the branch, the changed files and the changes themselves in the active pane's folder. From there you can also send the branch to GitHub.4 minEveryone6 steps
- SHIPIT keyboard shortcutsThese are the keys worth knowing. The full list is always one click away in Settings.3 minEveryone5 steps
- Terminal settings: font, scrollback, keysOne settings page applies to every pane. In a minute the terminal reads the way you like.4 minEveryone8 steps
Tools
Chat, prompts, the builder, routines and notifications.
- A website in SHIPIT: from questions to publishingYou answer a few simple questions, an agent builds the site while you watch, and SHIPIT shows it next to the chat. At the end you can put the site online for free.5 minBeginner8 steps
- A Telegram bot in SHIPIT: where to startSHIPIT turns your answers into a task for the bot and opens a project where an agent writes the code. The token, testing and where the bot lives are covered in detail by the Telegram guides.4 minBeginner5 steps
- Reminders and automations in SHIPITA morning summary, birthday greetings, a message before a calendar event. You describe when and what, and the agent picks the simplest way that needs no server of your own.4 minBeginner5 steps
- Chat: conversations, the composer and handing over to an agentChat is for thinking things through. When it is time to change something, an agent or a Code pane takes the conversation, and nothing has to be retyped.4 minEveryone8 steps
- Prompts: the library, the builder and your own draftsThe prompts you write again and again live in one place. One button drops the right one where you are working.3 minEveryone6 steps
- Plugins: services your agents can useA plugin gives an agent the tools of another service: GitHub, mail, payments, hosting. You connect a service once and decide which agents may use it.3 minPro5 steps
- Routines: an agent on a scheduleA routine is a message to an agent that SHIPIT sends by itself on a schedule. A code review every morning or a report every Monday, with no reminders.4 minIntermediate6 steps
- Dashboard: everything important on one pageDashboard puts the state of your repos, limits and sessions on one page. Look here in the morning and you see where to start.3 minIntermediate5 steps
- Notifications: when SHIPIT calls youSHIPIT calls you when an agent is done, waits for your answer or something fails. Tabs you have not opened for a while stay quiet so they do not get in the way.3 minEveryone6 steps
- Markdown files open in SHIPITA double-click on a .md file in Finder opens it in SHIPIT, in a pane next to your work. Here is how to turn it on, what you will see and how to undo it.2 minEveryone6 steps
- Links open in the SHIPIT browserA link from a terminal, chat or an agent's reply opens in a Browser pane next to your work. It is on from the start and turns off with one switch.2 minEveryone6 steps
Help
When something does not work: sign-in, access, background work, reporting a problem.
- Something is wrong: symptom and fixFind your symptom and do what it says. If that does not help, the last step shows how to tell us.5 minEveryone6 steps
- Sign-in problems: Dzhura account, Claude and CodexSHIPIT has two different sign-ins: your Dzhura account and your assistants. Here is how to sort out each.4 minEveryone6 steps
- Full Disk Access: one switch instead of a dozen promptsOne switch in macOS, and it stops asking about each protected folder while an agent works there.3 minEveryone5 steps
- When you quit SHIPIT: what stops and what comes backQuitting SHIPIT stops everything it started, and your open workspaces come back on the next launch.3 minEveryone5 steps
- Report a problem and crash reportsDescribe what went wrong, and we get it together with the app version. Automatic crash reports are sent only if you turn them on.3 minEveryone5 steps
- SHIPIT FAQThe essentials in brief: how to start, how agents work, privacy and your account. Common questions are answered below.5 minEveryone4 steps