Tutorials

cd your-project
arctic

In TUI: Press Ctrl+P, type "attach", select your project directory

arctic run -f . "I want to add user authentication to this API"

I need to add user authentication with these features:
- User registration (email/password)
- User login
- Password hashing with bcrypt
- JWT token generation
- Protected routes
- Password reset (email-based)

The API is built with Express and uses a MongoDB database.

Review the code and suggest improvements:
1. Add input validation
2. Add rate limiting
3. Add error handling
4. Add logging

# In Arctic, let it run the tests
"Please run the tests for the authentication system"

# Or manually
npm test

git add .
git commit -m "Add user authentication system"

ARCTIC_DEBUG=1 arctic

I have a memory leak in my React application. Here's what happens:
- Navigate to /dashboard
- Memory usage increases
- Navigate away and back
- Memory keeps increasing
- Eventually the browser becomes unresponsive

The dashboard component fetches data every 5 seconds and displays charts.

// Before: Missing cleanup
useEffect(() => {
  const interval = setInterval(() => {
    fetchData();
  }, 5000);
}, []);

// After: Proper cleanup
useEffect(() => {
  const interval = setInterval(() => {
    fetchData();
  }, 5000);

  return () => clearInterval(interval);
}, []);

"Please verify the memory leak is fixed by:
1. Checking all useEffect hooks
2. Ensuring all intervals/timeouts are cleared
3. Checking event listeners are removed
4. Testing navigation scenarios"

git diff main...feature-branch > changes.diff

cat changes.diff | arctic run "Review these changes thoroughly"

# Or attach the file
arctic run -f changes.diff "Review these changes"

Please review these changes and focus on:
1. Security vulnerabilities
2. Performance issues
3. Code quality and best practices
4. Test coverage
5. Documentation completeness

For each issue found, provide:
- The specific file and line
- The problem
- Why it's a problem
- A suggested fix

Please generate a PR review summary with:
- Overall assessment (approve/needs changes/reject)
- Key concerns
- Positive highlights
- Actionable checklist

Can you explain why this function was refactored this way?
[point to specific code]

What are the trade-offs of this approach?

arctic run "Analyze this codebase and identify:
1. Outdated patterns
2. Code smells
3. Security issues
4. Performance bottlenecks
5. Areas that would benefit from modernization"

Based on the analysis, create a prioritized refactoring plan.
For each item, include:
- What to change
- Why change it
- Estimated effort
- Risk level
- Dependencies on other changes"

Let's start with the easiest wins. Please:
1. Update all var to const/let
2. Convert function expressions to arrow functions
3. Add destructuring where appropriate
4. Use template literals instead of string concatenation

# Run tests
npm test

# Or ask Arctic to verify
"Please run the tests and verify all changes work correctly"

Now let's refactor the API layer:
1. Extract common request logic
2. Add error handling middleware
3. Implement proper error types
4. Add request/response logging

Please create a REFACTORING.md file that documents:
- What was changed
- Why it was changed
- Breaking changes (if any)
- Migration guide for other developers

arctic run -f src/user-service.ts "Analyze this module and identify:
1. All functions that need tests
2. Edge cases to cover
3. Error scenarios to test
4. Integration points to mock"

Please generate comprehensive test files using Jest that cover:
- Unit tests for each function
- Integration tests
- Error handling tests
- Edge case tests

Use proper mocking for external dependencies.

Review the generated tests and improve:
1. Test descriptions (make them clearer)
2. Test organization (group related tests)
3. Assertions (use more specific matchers)
4. Test data (use realistic data)

npm test

# Or with coverage
npm test -- --coverage

The following tests are failing. Please fix them:
[paste failing test output]

Please update the CI configuration to:
1. Run tests on every push
2. Require tests to pass
3. Generate coverage reports
4. Enforce minimum coverage thresholds

arctic run -f src/api/ "Analyze all API routes and document:
1. Endpoints (method, path)
2. Request parameters
3. Request body schema
4. Response format
5. Error responses
6. Authentication requirements"

Please generate documentation in OpenAPI 3.0 format that I can use with Swagger or ReDoc.

For each endpoint, include:
1. cURL example
2. Request payload example
3. Success response example
4. Error response example

# Generate getting started guide
arctic run "Generate a getting started guide for this API including:
1. How to authenticate
2. How to make your first request
3. Common use cases
4. Best practices"

# Generate troubleshooting guide
arctic run "Generate a troubleshooting guide covering:
1. Common errors
2. How to debug
3. Rate limits
4. Authentication issues"

Please create a Docusaurus site configuration and structure for this API documentation.
Include:
- Navigation structure
- Homepage
- Getting started page
- API reference pages
- Troubleshooting page

arctic run "I want to build a feature that allows users to export their data as CSV.
Please help me:

1. Define the requirements
2. Identify the technical approach
3. Plan the implementation steps
4. Identify potential issues
5. Create a task list"

# Create a feature branch
git checkout -b feature/data-export

# Start implementing
arctic run "Let's implement the data export feature step by step.
Start with the core functionality."

Now implement:
1. The CSV generation logic
2. The API endpoint
3. Frontend UI
4. Error handling
5. Progress tracking for large exports

# Generate tests
arctic run "Generate comprehensive tests for the data export feature"

# Run tests
npm test

# Manual testing
arctic run "Create a test plan for manual testing of the data export feature"

# Update API docs
arctic run -f src/api/export.ts "Generate API documentation for the export endpoint"

# Update user docs
arctic run "Write user documentation explaining how to use the data export feature"

# Update changelog
arctic run "Generate a changelog entry for this feature"

# Self-review
arctic run -f . "Review all changes in this feature branch for:
1. Security issues
2. Performance problems
3. Code quality
4. Best practices
5. Edge cases"

# Generate PR description
arctic run "Generate a pull request description for this feature including:
- Feature summary
- Changes made
- Testing done
- Breaking changes (if any)
- Screenshots (if applicable)"

# Deployment checklist
arctic run "Create a deployment checklist for this feature covering:
1. Database migrations needed
2. Environment variables
3. Feature flags
4. Monitoring
5. Rollback plan"

"Fix the code"

"Fix the authentication bug where users can't login after password reset.
The issue is in src/auth.js, line 45."