Formerly known as BBai
Beyond Better (BB) is an advanced AI-powered assistant designed to revolutionize how you work with text-based projects. Whether you're coding, writing, or managing complex documentation, BB is here to help you go beyond better at every step.
- Project Status: Beta
- Why Beyond Better?
- Who Can Benefit from Beyond Better?
- Use Cases
- How Beyond Better Works
- Getting Started
- Documentation
- Why Choose Beyond Better?
- Roadmap
- Join the Beyond Better Community
- Project Links
Beyond Better (BB) is currently in beta stage of development. While we're excited about its potential, please be aware that you may encounter bugs or incomplete features. We're actively working on improvements and new functionalities.
We're Seeking Testers and Contributors! If you're interested in being part of the Beyond Better journey, we'd love to hear from you. Whether you want to test the tool, contribute code, or share ideas, please reach out. Your input can help shape the future of BB.
To get involved, please submit an issue, or contact me directly.
In a world where AI assistants are becoming commonplace, Beyond Better stands out by offering a more comprehensive, project-wide approach to content creation and management. Born from the need for a more versatile and powerful tool than existing solutions, Beyond Better (BB) brings the full potential of large language models (LLMs) directly to your projects.
- Universal Text Support: From code to prose, Beyond Better handles it all.
- First-Class Project Discussions: Makes conversations about your project as important as the changes themselves.
- Conversation Management: Handles multiple conversations simultaneously for complex projects.
- Intelligent Tools: Employs LLM tools for clear, purpose-driven interactions.
- Custom Tools: Extend BB's capabilities with tools from the BB Tool Library or create your own.
- Web Page Fetching: The
FetchWebPagetool allows Beyond Better to retrieve content from web pages, providing additional context and information for the LLM to reference during conversations. - Web Page Screenshot: The
FetchWebScreenshottool enables Beyond Better to capture screenshots of web pages, allowing the LLM to analyze visual content when needed. - Project-Wide Understanding: Uses project file listing for initial project comprehension, with plans for advanced techniques like RAG and embeddings in the future.
- Multiple Interface Options: API, Browser User Interface (BUI), Command Line Interface (CLI), and future Desktop User Interface (DUI) for flexible usage.
Beyond Better (BB) is designed for a wide range of professionals working with text, including but not limited to:
- Software Developers
- Technical Writers
- Content Creators
- Fiction Authors
- Data Scientists
- Configuration Managers
Beyond Better (BB) excels in various scenarios:
- Code Refactoring: Analyze and improve code across an entire project.
- Documentation Updates: Keep your docs in sync with code changes.
- Content Creation: Generate and refine written content with AI assistance.
- Project Analysis: Get insights and summaries of large codebases or text projects.
- Learning and Exploration: Discuss and understand complex projects with an AI assistant.
- Project Understanding: Beyond Better uses advanced techniques to comprehend your entire project.
- Intelligent Conversations: Discuss your project, ask questions, and explore ideas with the AI.
- Coherent Changes: Make wide-ranging, consistent updates across your project with ease.
- Review and Iterate: Analyze changes, discuss further improvements, and refine your work.
BB Manager is a platform-specific tool designed to help you manage multiple BB projects efficiently:
- Windows:
bb-manager.bat- A batch script with a text-based menu interface. - macOS:
BB Manager.applescript- An AppleScript application providing a native GUI. - Linux:
bb-manager.sh- A shell script with a text-based menu interface.
BB Manager allows you to:
- List, add, and remove BB projects
- Run BB commands (init, start, stop) for specific projects
- Automatically set the correct working directory for each project
To use BB Manager, run the appropriate file for your platform after installation.
Before using Beyond Better (BB), ensure you have the following:
- An Anthropic API key (Note: This is different from your Anthropic chat console login. You'll need to create an API key at https://console.anthropic.com/settings/keys)
- Git (latest stable version, recommended but optional)
Git can be easily installed using package managers like Homebrew on macOS, Chocolatey on Windows, or apt on Linux. While Git is optional, it's highly recommended for optimal use of Beyond Better.
Beyond Better includes built-in TLS certificate management:
- Automatic certificate generation and trust store integration
- Secure HTTPS communication out of the box
- Easy management with
bb securecommand - Platform-specific trust store handling
See the Certificate Management Guide for details.
Beyond Better can be installed on various platforms:
-
macOS and Linux: Use our one-line installation script:
curl -sSL https://raw.githubusercontent.com/Beyond-Better/bb/main/install.sh | sh -
Windows: Download and run the
bb-installer.msifrom our Releases page. For detailed instructions, see our Windows User Guide. -
Manual Installation: For advanced users, we provide options to install from release packages or build from source.
For detailed installation instructions, please refer to our Installation Guide.
After installation, you can start using Beyond Better as follows:
-
Use BB Manager to add and manage your projects:
- Windows: Run
bb-manager.bat - macOS: Open
BB Manager.applescript - Linux: Run
bb-manager.sh
- Windows: Run
-
Use BB Manager to initialize a new project: Select 'Run BB command' and choose 'init' for your project.
-
Use BB Manager to start BB for a specific project: Select 'Run BB command' and choose 'start' for your project.
-
Alternatively, you can use BB directly from the command line:
bb init # Initialize BB in the current directory bb start # Start the BB API and open the browser interface bb chat # Start the BB API and use the command-line interface
On Windows, use bb.exe instead of bb when using the command line directly.
BB supports extending its functionality through custom tools available in the BB Tool Library:
- Find Tools: Browse and search for tools that enhance BB's capabilities
- Install Tools: Easily add tools to your BB installation
- Create Tools: Develop and publish your own tools using the @beyondbetter/tools package
- Share Tools: Contribute to the BB community by sharing your tools
For more information:
For detailed information on how to use Beyond Better (BB), please refer to our documentation:
- Understanding BB: Guide to working effectively with BB
- How BB Works: Technical deep dive into BB's operation
- Managing Conversations: Learn to manage conversations effectively
- Planning Templates: Templates for various project tasks
- Certificates: Certificate management guide
- Trust Store: Trust store configuration and management
- Security Troubleshooting: Security-related troubleshooting
- API Documentation: Explore the Beyond Better API endpoints for integrating BB into your workflows or building custom tools
- BUI Documentation: Learn about the Browser User Interface for Beyond Better
- CLI Documentation: Understand how to use the Beyond Better Command Line Interface for various operations
- DUI Documentation: Learn about the native application experience for managing the BB API server and services.
These guides provide comprehensive information on Beyond Better's features, usage patterns, and best practices to help you make the most of this powerful tool. For a complete overview of available documentation, see our Documentation Index.
- Holistic Approach: Unlike auto-complete tools, Beyond Better understands and reasons over your entire project.
- Versatility: Works with any text-based project, not just code.
- Efficiency: Streamlines the process of making large-scale, coherent changes.
- Learning Tool: Enhances understanding of complex projects through AI-assisted exploration.
- Future-Proof: Designed to grow with advancements in AI and LLM technology.
Beyond Better (BB) is continuously evolving. Here's an overview of our planned features and approximate timelines:
- Short-term (Next 3-6 months):
- Implementation of RAG and embedding capabilities for enhanced project understanding and comprehensive project visibility
- Initial support for additional LLM providers
- Medium-term (6-12 months):
- Agent Orchestrator: A powerful feature that allows the LLM to break down complex tasks into smaller chunks managed by sub-agents. This enables:
- Faster and more cost-effective processing for simple tasks using smaller models
- Reduced context window size and costs for multiple conversations
- Synchronous task completion for improved overall operation speed
- Expanded tool ecosystem for more specialized tasks
- Long-term (Beyond 12 months):
- Advanced integration with version control systems
- Collaborative features for team-based projects
- AI-driven project optimization suggestions
Please note that these timelines are approximate and subject to change based on development progress and community feedback.
Beyond Better is more than just a tool; it's a growing community of professionals pushing the boundaries of what's possible with AI-assisted work. Whether you're a seasoned developer or a curious writer, BB is here to help you go beyond better at what you do.
Start your journey with Beyond Better today and transform the way you work with text!
Beyond Better: Go Beyond Better at Everything You Do with Text
Beyond Better is designed to work on the following operating systems:
- macOS (10.15 Catalina and later)
- Linux (major distributions like Ubuntu, Fedora, CentOS)
- Windows 10 and later
It's compatible with projects using various programming languages and text-based formats.
We value your input and are here to help you get the most out of Beyond Better:
- For bug reports or feature requests, please open an issue on our GitHub repository.
- For general questions or discussions, join our community forum.
- For more immediate support, reach out to us via email at support@beyondbetter.dev.
Your feedback is crucial in shaping the future of Beyond Better!