From download to your first useful result.

Set up Alacrán, describe your business, and prepare your first draft for review. Start with one company and one task. You can add more tools and workflows later.

Before you start

A Mac, or a Debian or Ubuntu computer.

On a Mac, choose the download that matches your Mac’s chip. Step 1 shows how to check.

Git.

Alacrán keeps every company as a Git history, so Git has to be installed. The checklist you see on first launch tells you if it is missing.

An AI account for AI tasks.

Claude Code is the default, and it needs a paid Claude plan to sign in. If you already have Kiro, Kimi, Codex or Google Antigravity, you can choose that for each company instead. Alacrán is free; your AI provider’s subscription, usage limits and charges are separate. No AI yet? Choose Explore without AI and add your records first.

A short description of your business.

A sentence or two is enough to begin. You can improve the details as you work.

1. Install and open Alacrán.

Pick the instructions for your computer. You do not need an Alacrán account to create your local workspace.

On a Mac Follow these five things in order.

  1. Find your chip. Click the Apple menu, then About This Mac. If it says “Chip: Apple M1” (or M2, M3, M4), you have Apple Silicon. If it says “Processor: Intel”, you have Intel.
  2. Download the matching file with Download Alacrán: Mac Apple Silicon or Mac Intel.
  3. Open the downloaded .dmg and drag Alacrán into Applications.
  4. Open Terminal (press Cmd+Space, type Terminal, press Return). Paste the line below and press Return.
    xattr -cr "/Applications/Alacran.app"
  5. Open Alacrán from your Applications folder.

Why this step exists Apple has not notarized Alacrán, because that needs a paid Apple Developer account. Until you run the line above once, macOS may say “Alacrán is damaged and can’t be opened”. It is not damaged. The command clears the flag your browser attached to this one download, so macOS lets the app open. Right-click and Open is not enough on its own. Use it only on the app you downloaded from this site or the official releases page. Updates inside the app do not need it again.

On Debian or Ubuntu Open Terminal, go to the folder where you saved the download (usually Downloads), and run the line below. Use it only on the file you downloaded from this site or the official releases page. Then open Alacrán from your applications menu.

sudo apt install ./Alacran.deb

You will see Alacrán opens on a “Welcome to Alacrán” screen with a short checklist. It checks that you have Git and one AI tool, which the next steps cover.

2. Choose your starting goal.

You do not need to know your whole plan yet. Choose the work you want help with: running your business, building software, winning customers, or growing your audience. Read the trust information so you understand local storage, provider access, and review expectations.

Your starting goal helps shape the workspace. It does not lock you into one way of working.

You will see A screen that asks “What should Alacrán help you accomplish?” with four choices, then a screen headed “You stay in control”.

3. Connect your AI.

Alacrán needs an AI to do the writing, and you sign in to it yourself with your own account. Follow the AI setup screen to install and sign in to the supported agent. Return to Alacrán and use Re-check to confirm the connection.

You can choose Explore without AI if you want to look around and add records first. Connect an agent when you are ready for AI-generated work.

You will see A screen headed “Connect the AI that does the work”. Claude Code is listed as missing or not connected until you install it and sign in. Press Re-check when you come back.

4. Create your company.

Give the workspace a name and choose an appropriate starter pack. Alacrán creates a company folder for its facts, notes, decisions, and operational records.

If you already have a suitable project folder or backup, use the available import or restore option. Existing folders may follow a different onboarding path.

You will see A list headed “What gets created”, and a form to name your company on the New Company tab.

5. Describe how your business works.

Your AI is only as useful as what it knows about you, so answer the guided questions:

  • What does your business do, and who does it serve?
  • Who is involved: customers, team members, partners, or suppliers?
  • How does work move from a request to a finished result?
  • What takes up the most time today?

Keep unknown details visibly incomplete rather than filling them with assumptions.

On Check & save, choose Let Alacrán write it up to prepare a draft for approval, or Save my answers as they are to keep your own wording.

You will see Four short screens (What you do, Who’s involved, How work flows, What’s hardest), then Check & save with those two buttons.

6. Review your first draft.

Nothing is saved until you say so. Open Approvals and inspect the proposed company information. Choose Review & approve, Ask for changes, or Discard.

Your company profile influences later tasks, so check its facts carefully. Some previews currently show structured text such as name: value rather than a formatted summary.

You will see Approvals reads your draft back in plain sentences and marks it “High risk”. That only means everything Alacrán does later builds on your company profile, so it deserves a careful read. It does not mean anything is wrong. After you approve, a line reads “Saved. Alacrán keeps it in your company’s files.”

7. Ask a useful first question.

Open the assistant and ask

Based on the information I have saved, what needs my attention and what information is still missing?

For a follow-up task, try

Draft a short introduction to my business using the company profile. Mark anything that needs my confirmation.

Review the result before using it outside the workspace.

You will see An answer written from the company profile you just saved. Anything it could not find should be listed as missing, so you know what to add next.

If something needs attention

The agent is installed but not connected.

Complete its sign-in, check provider access, and run Re-check again.

A job finishes without a result.

Check the run status and provider usage limits. Review the reported error before retrying.

A connection is missing.

Open Connections or System Doctor to inspect requirements and suggested fixes.

The app looks too technical.

Keep Advanced mode off while you learn the main workflows. Some current setup and review screens may still expose technical details.

I closed the window, but work is continuing.

Closing the window can leave Alacrán running in the background. Use Quit when you want to stop the application.

Choose your next step.

Put your business knowledge to work.

Create your company workspace, connect your AI, and prepare your first result for review.

Your download has started. One more step on a Mac.

Apple has not notarized Alacrán, because that needs a paid Apple Developer account. Until you do this once, macOS may block the app, often with the message "Alacrán is damaged and can't be opened". It is not damaged.

  1. Install. Open the downloaded .dmg and drag Alacrán into Applications.
  2. Run this in Terminal, once. It clears the quarantine flag macOS puts on downloaded files. Use it only on the app you downloaded from this site or the official releases page.
    xattr -cr "/Applications/Alacran.app"
  3. Open Alacrán from Applications.

You only need this for the first install. Updates inside the app do not need it. Prefer to read more? Read the setup guide.