Each task in this document includes clear instructions, example commands, and best practices to help you get the most from BLACKBOX CLI.
Create new projects from scratch
Build a complete web application
Suppose you want to create a full-featured web application with modern technologies.
Start BLACKBOX CLI session
Request project creation
> create a todo list web app using React, TypeScript, and Tailwind CSS
Add advanced features
> add user authentication and data persistence to the todo app
> implement drag-and-drop functionality for reordering tasks
> add dark mode toggle and responsive design
Set up development environment
> configure the development server and build scripts
Tips:
- Start with a clear description of what you want to build
- Ask for modern best practices and technologies
- Request proper project structure and organization
Generate API backends
Suppose you need to create a REST API for your application.
Specify API requirements
> create a Node.js Express API for a blog application with user management
Add database integration
> add PostgreSQL database integration with Prisma ORM
Implement authentication
> add JWT authentication and authorization middleware
Add comprehensive endpoints
> create CRUD endpoints for posts, comments, and user profiles
Tips:
- Specify the database and ORM you prefer
- Request proper error handling and validation
- Ask for API documentation generation
Debug and fix existing code
Suppose you’ve encountered errors in your application and need to identify and fix them quickly.
Describe the problem
> my React app crashes when users try to submit the contact form
Let BLACKBOX CLI analyze the issue
> analyze the contact form component and find the bug
Apply the recommended fix
> fix the form validation error and add proper error handling
Test the solution
> test the contact form to ensure it works correctly now
Tips:
- Provide specific error messages when available
- Mention the steps to reproduce the issue
- Ask for explanations of why the bug occurred
Improve and optimize existing code
Suppose you need to enhance the performance and maintainability of your codebase.
Identify optimization opportunities
> analyze my React components for performance issues
Apply performance improvements
> optimize the user dashboard component to reduce re-renders
Refactor for better maintainability
> refactor the authentication logic into reusable hooks
Add modern patterns
> update the state management to use React Query for server state
Tips:
- Ask for specific performance metrics and improvements
- Request explanations of optimization techniques used
- Focus on one area at a time for manageable changes
Add new features to existing projects
Suppose you want to extend your application with additional functionality.
Analyze current architecture
> review my e-commerce app structure and suggest where to add a wishlist feature
Implement the new feature
> add a wishlist feature with add/remove functionality and persistence
Integrate with existing components
> update the product cards to include wishlist buttons
Add supporting features
> create a wishlist page where users can view and manage saved items
Tips:
- Consider how new features integrate with existing code
- Ask for consistent styling and user experience
- Request proper testing for new functionality
Set up development environments
Suppose you need to configure a complete development environment for your project.
Configure build tools
> set up Webpack configuration for my React TypeScript project
Add development server
> configure hot reloading and development server with proxy settings
Set up testing environment
> configure Jest and React Testing Library for unit testing
Add code quality tools
> set up ESLint, Prettier, and Husky for code formatting and pre-commit hooks
Tips:
- Ask for modern development best practices
- Request configuration for your specific tech stack
- Include deployment preparation in your setup
Generate comprehensive tests
Suppose you need to add thorough testing coverage to your application.
Analyze testing needs
> identify which components and functions need test coverage
Generate unit tests
> create comprehensive unit tests for the user authentication service
Add integration tests
> write integration tests for the shopping cart functionality
Create end-to-end tests
> set up Cypress tests for the complete user registration flow
Tips:
- Ask for tests that cover edge cases and error conditions
- Request both positive and negative test scenarios
- Include tests for user interactions and API calls
Deploy applications
Suppose you need to deploy your application to production.
Prepare for deployment
> optimize my React app for production deployment
Configure deployment platform
> set up deployment to Vercel with environment variables
Set up CI/CD pipeline
> create GitHub Actions workflow for automated testing and deployment
Configure monitoring
> add error tracking and performance monitoring to the deployed app
Tips:
- Specify your preferred deployment platform
- Ask for environment-specific configurations
- Include monitoring and error handling setup
Work with databases
Suppose you need to design and implement database functionality.
Design database schema
> design a PostgreSQL schema for a social media application
Set up database connection
> configure Prisma ORM with PostgreSQL for my Node.js API
Create database operations
> implement CRUD operations for users, posts, and comments
Add advanced queries
> create queries for user feed with pagination and filtering
Tips:
- Specify your database technology and ORM preferences
- Ask for proper indexing and performance considerations
- Request data validation and security measures
Convert between technologies
Suppose you need to migrate or convert your project to different technologies.
Analyze current implementation
> review my jQuery application and plan migration to React
Convert components gradually
> convert the user dashboard from jQuery to React component
Update styling approach
> migrate CSS styles to Tailwind CSS classes
Modernize JavaScript
> convert JavaScript functions to TypeScript with proper types
Tips:
- Plan migrations in small, manageable steps
- Ask for compatibility considerations during transition
- Request testing strategies for converted code
Learn and understand code
Suppose you need to understand an existing codebase or learn new concepts.
Get project overview
> explain the architecture and main components of this React application
Understand specific patterns
> explain how the state management works in this Redux setup
Learn implementation details
> walk me through how user authentication is implemented here
Get improvement suggestions
> suggest modern alternatives to the patterns used in this codebase
Tips:
- Ask for explanations in terms you understand
- Request examples and comparisons to familiar concepts
- Focus on one area at a time for better comprehension
Manage concurrent development workflows with Git worktrees
Imagine you need to tackle multiple coding tasks at the same time while keeping each Blackbox CLI instance completely separate for better context of changes and isolation of work.
What is Git worktrees
Git worktrees let you check out different branches from the same repository into separate folders. Each folder gets its own working directory with independent files, but they all share the same Git history. Check out the official Git worktree guide for more details. Set up a new worktree
# Set up a new worktree with a fresh branch
git worktree add ../my-new-feature -b enhancement-ui
# Or set up a worktree for an existing branch
git worktree add ../my-app-fix fix-login-issue
Launch Blackbox CLI in each worktree
# Move to your worktree directory
cd ../my-new-feature
# Start Blackbox CLI in this isolated space
blackbox
Launch Blackbox CLI in another worktree
cd ../my-app-fix
blackbox
Oversee your worktrees
# View all active worktrees
git worktree list
# Clean up a worktree when finished
git worktree remove ../my-new-feature
Tips:
- Each worktree maintains its own file state, ideal for simultaneous Blackbox CLI sessions
- Modifications in one worktree don’t impact others, ensuring Blackbox instances operate independently
- All worktrees access the same Git history and remote repositories
- For extended tasks, let Blackbox work in one worktree while you code in another
- Choose clear folder names to quickly identify each worktree’s purpose
- Set up your development environment in each new worktree based on your project’s needs, which may involve:
- JavaScript projects: Installing dependencies (
npm install, yarn install)
- Python projects: Creating virtual environments or using package managers
- Other languages: Following your project’s standard initialization steps
Ask Blackbox CLI about its own capabilities through direct queries
Want to learn more about Blackbox and its capabilities? Why not ask the agent itself for detailed insights and guidance. BlackBox CLI has access to its own documentation and can answer questions about its features and limitations.
Example queries to explore BLACKBOX AI
Start a session with blackbox and try these example prompts:
> what are the main features of Blackbox CLI and how do they help developers?
> Can BlackBox CLI create a pull request for me?
> What commands does BlackBox CLI support?
> what are some advanced tips for getting the most out of BLACKBOX AI sessions?
> how can I integrate Blackbox CLI with my existing development workflow?
BlackBox CLI provides documentation-based answers to these questions. For executable examples and hands-on demonstrations, refer to the specific use-case sections above.
Tips:
- Phrase your questions clearly to get precise, helpful responses
- Follow up on answers with more detailed queries for deeper understanding
- Use the agent’s knowledge to discover lesser-known features or optimizations
- Compare Blackbox capabilities with other tools by asking for side-by-side explanations
