Installation & Setup
Follow this step-by-step guide to get started with 8090 Software Factory.
Start New Project → Create Project
Once in Refinery, navigate to the top-left module selector and select Project Console
Select the Integrations tab in Project Console
You’ll be redirected to GitHub to authorize the 8090 Software Factory GitHub App to read your repository
After authorization, return to Software Factory
You’ll be asked to specify the repository you’d like to index (currently only the main branch is supported)
Enter your repository URL and press Authorize
You should see a confirmation that the integration was created successfully
Navigate to Project Console → Codebase in the left sidebar
You’ll see indexing in progress
Indexing typically takes 1–10 minutes, depending on the size of your repo
Once complete, you’ll see a success message confirming that your codebase is indexed
Coding agents like Cursor or Claude Code can retrieve and execute Work Orders by connecting to Software Factory via MCP. Any MCP-compliant client is supported.
Navigate to Assembler in the top-left module selector
A popup will appear with setup instructions for connecting your coding agent
For Cursor: We offer 1-click integration
For other MCP clients: We provide a JSON connection string in the mcp.json format
After completing setup:
Refinery - Start defining your product requirements
Foundry - Translate requirements into technical specs
Planner - Generate actionable work orders
Assembler - Connect your coding agent and start building
Validator - Set up feedback collection
GitHub Integration Fails
Ensure you have admin access to the repository
Check that the repository is public or you have proper permissions
Verify the repository URL format
Indexing Stuck
Large repositories may take longer to index
Check your internet connection
Contact support if indexing takes more than 30 minutes
MCP Connection Issues
Verify your coding agent supports MCP
Check that the connection string is copied correctly
Ensure your agent has the necessary permissions
If you encounter issues:
Check the troubleshooting guide
Join our Discord community
Contact enterprise support for urgent issues
Ready to start building? Learn about Refinery →
