Quick Start Guide 🚀

Follow these steps to create your first task.

1. Registration

1. Go to The Box platform: https://the-box.dev
2. Click the Sign Up button
3. You can register in two ways:
   • Email registration — Enter your email, password, and name
   • GitHub registration — Click Continue with GitHub for quick sign-up
4. Click the Register button

✅ After successful registration, you will be automatically logged in.

2. Claude Code Authentication

⚠️ IMPORTANT: You must log in to Claude Code before creating a task!

1. Go to the Settings page
2. Find the Claude Authentication section
3. Click the Start Authentication button
4. Open the OAuth URL in a new tab
5. Get the token from Claude
6. Enter the token and click Complete Authentication
7. If you see a green checkmark, you're ready! ✅

3. GitHub App Installation

1. Go to the GitHub Integration section on the Settings page
2. Click the Install GitHub App button
3. Select the required repositories on the GitHub page
4. Click the Install button

✅ Now you have access to your GitHub repositories.

4. Creating Your First Task

1. Return to the Dashboard page
2. Fill out the Create Task form:
   • Prompt: For example, "Add a README file with project description"
   • Mode: Planning (safe option — shows the plan first)
   • Repository: Select your GitHub repository
   • Branch: Select main or another branch
3. Click the Create Task button

✅ Task created and started!

5. Real-time Monitoring

On the task page, you'll see Claude's every action live:

• 🧠 Thinking — Claude is thinking
• 🔧 Tool Use — Reading or writing files
• 💬 Message — Messages
• 📋 Plan — Plan prepared (in Planning mode)

If you selected Planning mode, Claude will first show the plan and wait for your confirmation.

Click the Confirm Plan button and Claude will continue working.

6. Viewing Results on GitHub

After the task is completed:

1. Claude creates a new branch on GitHub
2. A Pull Request is automatically opened
3. Click the View PR button on the task page
4. View your code on GitHub and merge it! 🎉

---

What's Next?

Congratulations! 🎊 You have successfully created your first task.

Tips:

• Edit mode — For quick tasks (doesn't show the plan)
• Model selection — Claude Sonnet (standard), Haiku (fast), or Opus (complex tasks)
• Scheduled tasks — Delay task execution (15min, 30min, 1h, 2h, 4h)

Happy coding! 💻✨