Agnixa Documentation

Welcome to Agnixa, your AI-powered DevOps engineer. Agnixa automates your CI/CD pipeline, manages deployments, and helps you maintain code quality through intelligent automation.

This documentation will guide you through setting up Agnixa, connecting your repositories, and leveraging AI to streamline your development workflow.

What is Agnixa?

Agnixa is an enterprise-grade DevOps automation platform that uses artificial intelligence to understand your codebase, automate deployments, run tests, and maintain code quality. It integrates seamlessly with GitHub, GitLab, and Bitbucket to provide intelligent automation for your entire development lifecycle.

Support & Contact

Need help? Our support staff is here to assist you with any questions or issues you may encounter.

Email Support

Get help from our support staff via email. We typically respond within 24 hours.

contact.agnixa@gmail.com

Enterprise Support

Need dedicated support? Contact our sales staff for enterprise support options.

Contact Sales →

Getting Started

Follow this complete workflow to get started with Agnixa and automate your DevOps tasks.

1

Purchase Plan & Complete Profile

After purchasing your Agnixa subscription plan, log in to your account and complete your user profile with the following information:

  • Full Name: Your complete name for account identification
  • Username: A unique username for your Agnixa account
  • Mobile Number: Contact number for important notifications
  • Timezone: Your local timezone for accurate scheduling and logs

Tip: Complete your profile information accurately to receive timely notifications about deployments, build status, and system alerts.

2

Create Your Project

Create a new project in Agnixa by providing the following details:

Project Name

A descriptive name for your project (e.g., "E-commerce Platform", "Mobile App Backend")

Owner / Organization

Your GitHub/GitLab username or organization name that owns the repository

Repository Name

The exact name of your repository as it appears in your Git provider

Branch

The branch you want Agnixa to work with (e.g., "develop", "staging", "feature/new-feature")

Important: Do NOT use "main" or "master" branches

3

Configure Repository Settings

Connect your repository by adding your personal access token:

  1. Navigate to the Settings section in your Agnixa dashboard
  2. Select your Git provider (GitHub or GitLab)
  3. Create a personal access token from your Git provider (see Access Token Setup section)
  4. Paste the token into the "Personal Access Token" field
  5. Click "Save" to establish the connection

Security Note: Your access token is encrypted and stored securely. Never share your token with anyone or commit it to your repository.

4

Conversation History (brain.agent)

Once your project is configured, Agnixa automatically creates a brain.agent file to maintain conversation history and context for your project.

The brain.agent file contains:

  • Project Name: Your project identifier
  • Conversation History: All your interactions with the AI DevOps Engineer
  • Context Memory: Important decisions, configurations, and patterns learned from your workflow
  • Action History: Record of all automated tasks performed by Agnixa

Benefit: The brain.agent file allows Agnixa to understand your project's context over time, making responses more accurate and relevant to your specific workflow.

5

Use Quick Actions

Once everything is set up, you can use Quick Actions for common DevOps tasks. Click on any quick action button to instantly execute pre-configured workflows:

CI/CD Pipeline

Automatically generate and configure CI/CD pipelines for your project. Agnixa analyzes your codebase and creates optimized build, test, and deployment workflows.

Server Deploy

Deploy your application to staging or production servers with a single click. Agnixa handles the deployment process, runs health checks, and provides detailed logs.

Code Analysis

Run comprehensive code analysis to identify security vulnerabilities, code quality issues, performance bottlenecks, and best practice violations.

Pro Tip: You can also type custom prompts in the chat interface for more specific tasks beyond the quick actions. Agnixa understands natural language and can handle complex DevOps workflows.

🚀 You're Ready to Go!

After completing these 5 steps, you're all set to leverage Agnixa for intelligent DevOps automation. Your AI DevOps Engineer is ready to help you deploy faster, test smarter, and maintain higher code quality.

Start by trying a quick action or type a custom prompt like "Deploy to staging" or "Run all tests and report results".

Authentication

Before you can use Agnixa, you need to create an account and log in to the platform.

Creating an Account

To create a new Agnixa account:

  1. Visit the Agnixa homepage and click "Get Started"
  2. Enter your email address and create a secure password
  3. Verify your email address by clicking the link sent to your inbox
  4. Complete your profile by adding your name and organization details
  5. Choose a subscription plan or start your free trial

Logging In

To log in to your existing Agnixa account:

  1. Navigate to the Agnixa login page
  2. Enter your registered email address and password
  3. Click "Log In" to access your dashboard
  4. If you've enabled two-factor authentication, enter your verification code

Important Note

You must be logged in to configure repositories and use Agnixa. Without authentication, you will not be able to enter prompts or access any automation features.

Creating Personal Access Tokens

To connect your repository to Agnixa, you need to create a personal access token from your Git provider. Follow the instructions below for your specific platform.

GitHub

To create a personal access token on GitHub:

  1. Log in to your GitHub account
  2. Click on your profile picture in the top-right corner and select "Settings"
  3. Scroll down and click "Developer settings" in the left sidebar
  4. Click "Personal access tokens" → "Tokens (classic)"
  5. Click "Generate new token" → "Generate new token (classic)"
  6. Give your token a descriptive name (e.g., "Agnixa DevOps")
  7. Set an expiration date (recommended: 90 days)
  8. Select the following scopes:
    • repo - Full control of private repositories
    • workflow - Update GitHub Action workflows
    • read:org - Read organization data
  9. Click "Generate token" at the bottom of the page
  10. Copy the token immediately (you won't be able to see it again)

Warning: Store your token securely. Never commit it to your repository or share it publicly.

GitLab

To create a personal access token on GitLab:

  1. Log in to your GitLab account
  2. Click on your profile picture in the top-right corner
  3. Select "Preferences" from the dropdown menu
  4. In the left sidebar, click "Access Tokens"
  5. Enter a name for your token (e.g., "Agnixa DevOps")
  6. Set an expiration date (optional but recommended)
  7. Select the following scopes:
    • api - Access the authenticated user's API
    • read_repository - Read repository data
    • write_repository - Write to repository
  8. Click "Create personal access token"
  9. Copy the token immediately (it will only be shown once)

Warning: Keep your token secure and never expose it in your code or version control.

Bitbucket

To create an app password on Bitbucket:

  1. Log in to your Bitbucket account
  2. Click on your profile picture in the bottom-left corner
  3. Select "Personal settings" from the menu
  4. Under "Access management," click "App passwords"
  5. Click "Create app password"
  6. Enter a label for your password (e.g., "Agnixa DevOps")
  7. Select the following permissions:
    • Repositories: Read - Read repository data
    • Repositories: Write - Write to repositories
    • Pull requests: Read - Read pull requests
    • Pull requests: Write - Create and update pull requests
  8. Click "Create"
  9. Copy the generated password immediately (it cannot be retrieved later)

Warning: Treat your app password like a regular password. Store it securely and never share it.

Configuration

Once you have your personal access token, you need to configure Agnixa with your repository details.

Configuration Steps

Follow these steps to configure your repository in Agnixa:

1. Access Configuration Panel

After logging in, navigate to your dashboard and click on "Add Repository" or "Configure New Project" button.

2. Select Git Provider

Choose your Git provider from the dropdown menu (GitHub, GitLab, or Bitbucket).

3. Paste Access Token

In the "Access Token" field, paste the personal access token you created earlier. This token will be encrypted and stored securely.

Example: ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

4. Enter Organization Name

Enter your organization or username. This is the account that owns the repository.

Example: my-company or my-username

5. Enter Repository Name

Enter the exact name of your repository as it appears in your Git provider.

Example: my-awesome-project

6. Specify Branch

Enter the branch name you want Agnixa to work with. This is typically your development or staging branch (e.g., "develop", "staging", "feature/new-feature").

Example: develop

Important: Do NOT use "main" or "master" branches. Agnixa cannot merge directly to production branches for safety reasons.

7. Save Configuration

Click "Save" or "Connect Repository" to complete the configuration. Agnixa will validate your credentials and establish the connection.

Connecting to Your Repository

After entering your configuration details, Agnixa will automatically verify the connection to your repository.

Connection Process

Automatic Verification

When you submit your configuration, Agnixa will:

  • Validate your access token
  • Verify access to the specified organization and repository
  • Check permissions on the specified branch
  • Test API connectivity with your Git provider

Connection Status Indicators

You'll see visual indicators showing the connection status:

Connected: Repository successfully connected
Connecting: Verifying credentials
Failed: Connection error (check credentials)

Success!

Once you see the green checkmark (✓), your repository is successfully connected and you can start using Agnixa to automate your DevOps workflow.

Troubleshooting Connection Issues

If your connection fails, check the following:

  • Verify your access token is correct and hasn't expired
  • Ensure the organization/username and repository name are spelled correctly
  • Confirm the branch name exists in your repository
  • Check that your token has the required permissions
  • Verify your Git provider's API is accessible

Using Agnixa

Once your repository is connected, you can start using Agnixa to automate your DevOps tasks.

Prerequisites

You MUST complete the configuration and see the connection success indicator before you can enter prompts. Without a connected repository, the prompt interface will be disabled.

How Agnixa Works

Code Analysis First

Before Agnixa can help you with any task, it needs to understand your codebase. When you first connect your repository or submit your first prompt, Agnixa will:

  1. Analyze your code structure: Agnixa scans your repository to understand the project architecture, file organization, and dependencies.
  2. Identify technologies: Detects frameworks, languages, build tools, and deployment configurations you're using.
  3. Map relationships: Understands how different parts of your code interact with each other.
  4. Create execution plan: Based on the analysis, Agnixa creates a detailed plan for your requested task.

Note: The initial code analysis may take a few moments depending on your repository size. Subsequent prompts will be faster as Agnixa maintains an understanding of your codebase.

Entering Prompts

After successful connection, you can interact with Agnixa using natural language prompts:

Example Prompts

Deployment:

"Deploy the latest changes to staging environment"

Testing:

"Run all unit tests and report any failures"

Code Review:

"Review the latest pull request and check for security issues"

Build:

"Build the Docker image and push to registry"

Best Practices

  • Be specific in your prompts - include details about what you want to accomplish
  • Review Agnixa's proposed actions before confirming execution
  • Start with simple tasks to understand how Agnixa interprets your requests
  • Use clear, action-oriented language (e.g., "deploy", "test", "build")
  • Specify environments, branches, or services when relevant

AI Response Flow

When you submit a prompt, Agnixa will:

  1. Analyze your request and understand the intent
  2. Check your repository for relevant code and configuration
  3. Propose a plan of action with specific steps
  4. Ask for your confirmation before executing
  5. Execute the approved actions
  6. Provide detailed feedback and results

Restrictions & Safety Measures

Agnixa implements several safety measures to protect your production code and ensure responsible automation.

Main/Master Branch Protection

Agnixa CANNOT merge code directly to main or master branches. This is a critical safety feature to prevent accidental production deployments.

All changes must go through your standard code review process before being merged to production branches. Agnixa can create pull requests, but human approval is required for final merges to main/master.

Code Review Requirement

Before any code changes are merged, you must:

  • Review all proposed changes carefully
  • Understand what Agnixa is doing and why
  • Verify the changes align with your requirements
  • Check for any unintended side effects
  • Approve or reject the changes explicitly

Scope Limitation

Agnixa will only perform the specific tasks you request. It will:

  • Execute only what you explicitly ask for
  • Ask for clarification if your request is ambiguous
  • Warn you about potentially risky operations
  • NOT make unauthorized changes to your codebase
  • NOT perform actions beyond your request scope
  • NOT make assumptions about what you "might" want

Confirmation Required

For critical operations (deployments, deletions, production changes), Agnixa will always ask for explicit confirmation before proceeding. Never rush through these confirmations - take time to review what will happen.

Subscription Plans

Agnixa offers flexible subscription plans to match your needs and scale.

Available Plans

Basic

Perfect for individuals getting started with DevOps automation. Includes 200 prompt credits and 10 CI/CD pipelines.

Pro

For professionals who need advanced automation and analytics. Includes 500 prompt credits and unlimited pipelines.

Enterprise

For large organizations requiring enterprise-grade solutions. Includes unlimited prompts, custom SLA, and dedicated support.

View Detailed Pricing

For complete pricing information, feature comparisons, and to start your free trial, visit our pricing page.

View Pricing Plans →

Security Best Practices

Security is paramount when granting access to your repositories. Follow these best practices to keep your code and infrastructure secure.

⚠️ CRITICAL: Limited Permissions Only

NEVER grant administrator or owner-level access to your access token.This is strictly prohibited and creates unnecessary security risks.

Agnixa only needs specific, limited permissions to function. Granting excessive permissions violates security best practices and may result in account suspension.

Recommended Permissions

Grant ONLY the minimum permissions required:

✓ Required Permissions:

  • Read repository content
  • Write to repository (for creating branches and commits)
  • Read and write pull requests
  • Read organization data (if applicable)
  • Update workflow files (for CI/CD automation)

✗ DO NOT Grant:

  • Administrator access
  • Owner permissions
  • Delete repository permissions
  • Manage organization settings
  • Manage billing or subscriptions
  • Access to all repositories (scope to specific repos only)

Token Security Guidelines

  • Set expiration dates: Configure tokens to expire after 90 days and rotate them regularly
  • Use unique tokens: Create separate tokens for each service or application - never reuse tokens
  • Store securely: Never commit tokens to version control or share them in plain text
  • Monitor usage: Regularly review token activity in your Git provider's audit logs
  • Revoke immediately: If a token is compromised or no longer needed, revoke it immediately
  • Limit scope: Only grant access to specific repositories that need automation, not all repositories

Additional Security Measures

  • Enable two-factor authentication (2FA): Protect your Agnixa account with 2FA for an extra layer of security
  • Use IP allowlisting: If your Git provider supports it, restrict token usage to specific IP addresses
  • Review audit logs: Regularly check Agnixa activity logs to ensure all actions are authorized
  • Implement branch protection: Use your Git provider's branch protection rules to require reviews before merging
  • Separate environments: Use different tokens and configurations for development, staging, and production

Compliance & Data Protection

Agnixa is compliant with industry security standards:

  • SOC 2 Type II certified
  • GDPR compliant for data protection
  • HIPAA compliant for healthcare applications
  • All data encrypted in transit (TLS 1.3) and at rest (AES-256)
  • Regular third-party security audits
  • Zero-knowledge architecture for sensitive credentials

Report Security Issues

If you discover a security vulnerability or have security concerns, please report them immediately to our security staff:

security@Agnixa.com

We take all security reports seriously and will respond within 24 hours.

Free Trial

Experience the full power of Agnixa with our 14-day free trial. No credit card required.

What's Included

During your free trial, you get full access to all Agnixa features:

  • 100 prompt credits to test all AI capabilities
  • Access to all three Agnixa Brains (Blueprint, Recon, AutoX)
  • Unlimited repository connections
  • Full CI/CD pipeline generation
  • Complete security scanning and compliance checks
  • Infrastructure automation with Terraform

How to Start Your Trial

  1. Sign up for a free Agnixa account
  2. Complete your profile information
  3. Click "Start Free Trial" on the pricing page
  4. Connect your first repository and start automating

After Your Trial

When your 14-day trial ends, you'll automatically transition to the Basic Plan at $19/month. You can upgrade to Pro or Enterprise at any time, or cancel if Agnixa isn't the right fit.

All your projects, configurations, and conversation history are preserved when you transition to a paid plan.

Trial Best Practices

  • Start with a small project to understand how Agnixa works
  • Try all three Brains to see which ones fit your workflow
  • Test different types of prompts and automation tasks
  • Connect multiple repositories to test scalability
  • Reach out to support if you have questions or need guidance

Agnixa Brains

Agnixa Brain is our agentic AI system that powers intelligent DevOps automation. It consists of three specialized AI agents, each designed for a specific phase of the software development lifecycle.

What Makes Agnixa Brain Different

Unlike traditional automation tools that follow rigid scripts, Agnixa Brain uses agentic AI to understand context, make intelligent decisions, and adapt to your specific codebase and workflow.

  • Understands natural language prompts and translates them into actionable plans
  • Analyzes your entire codebase to make informed decisions
  • Learns from your project structure and coding patterns
  • Adapts recommendations based on your tech stack and constraints
  • Operates autonomously while keeping you in control

The Three Brains

Each Brain specializes in a different aspect of DevOps automation:

Blueprint

Transforms vague requirements into structured execution plans. Handles architecture design, tech stack decisions, and task breakdown.

Recon

Scans every layer of your codebase for security vulnerabilities, compliance issues, and code quality problems. Supports SAST, SOC2, GDPR, HIPAA, and CVE detection.

AutoX

Reads your stack, writes CI/CD pipelines, provisions infrastructure, and handles deployments. Supports GitHub Actions, GitLab CI, AWS, GCP, and Azure.

Plan-Based Access

Brain availability depends on your subscription plan:

Trial

Full access to all three Brains (Blueprint, Recon, AutoX) for 14 days

Basic

Access to Blueprint and Recon only

Pro

Full access to all three Brains with unlimited usage

Enterprise

Full access to all three Brains with dedicated support and custom SLA

Blueprint Brain

Blueprint turns vague requirements into structured execution plans. It thinks like a senior architect, planning, structuring, and mapping your entire project before a single line of code is written.

Key Capabilities

  • Designing multi-tier system architectures from a single prompt
  • Generating full PRDs, API contracts, and database schemas automatically
  • Breaking epics into sprint-ready tasks with effort estimates
  • Choosing the right tech stack based on your scale and constraints
  • Identifying risks, dependencies, and bottlenecks before development starts

How Blueprint Works

Blueprint's agentic AI analyzes your requirements and creates comprehensive plans:

  1. Requirement Analysis: Understands your business goals, technical constraints, and success criteria
  2. Architecture Design: Creates system diagrams, component relationships, and data flow models
  3. Risk Assessment: Identifies circular dependencies, single points of failure, scalability bottlenecks, and compliance gaps
  4. Task Breakdown: Generates sprint-ready tasks with dependencies, effort estimates, and acceptance criteria
  5. Documentation: Produces technical documentation, API specs, and implementation guides

Example Use Cases

Microservices Architecture:

"Design a microservices architecture for an e-commerce platform with user management, product catalog, order processing, and payment integration"

Database Schema:

"Create a database schema for a social media platform with users, posts, comments, likes, and real-time messaging"

API Design:

"Generate a RESTful API specification for a project management tool with authentication, projects, tasks, and team collaboration"

Availability

Blueprint is available on all Agnixa plans including Trial, Basic, Pro, and Enterprise. Pro and Enterprise plans unlock unlimited sessions, document exports, and technical specific documentation.

Recon Brain

Recon scans every layer of your codebase to find security vulnerabilities, compliance issues, and code quality problems. It investigates like a security auditor, compliance officer, and senior engineer rolled into one.

Key Capabilities

  • Full 5-layer code analysis: static → SAST → compliance → secrets → CVEs
  • SOC 2, GDPR, and HIPAA compliance scoring per framework
  • Detecting hardcoded secrets across entire git history
  • Terraform and IaC misconfiguration scanning
  • Auto-generating PRs with findings and suggested fixes

How Recon Works

Recon's agentic AI performs comprehensive security and compliance analysis:

  1. Static Analysis: Scans code for syntax errors, code smells, and anti-patterns
  2. SAST Scanning: Identifies security vulnerabilities using static application security testing
  3. Compliance Checking: Cross-references code against SOC 2, GDPR, HIPAA, and other regulatory frameworks
  4. Secret Detection: Finds hardcoded credentials, API keys, and tokens in current code and git history
  5. CVE Detection: Checks dependencies against known vulnerability databases (OWASP Top 10, CVE)
  6. Priority Mapping: Ranks issues by severity and maps each to exact line, file, and regulation violated

Supported Languages & Frameworks

Recon currently supports:

  • Python, Node.js, Go, Java and others
  • Terraform and Infrastructure as Code (IaC)
  • Docker and container configurations
  • Kubernetes manifests and Helm charts
  • More languages and frameworks on the roadmap

Example Use Cases

Security Audit:

"Run a full security scan on my repository and identify all OWASP Top 10 vulnerabilities"

Compliance Check:

"Check my codebase for GDPR compliance and generate a compliance report"

Secret Detection:

"Scan git history for any hardcoded credentials or API keys"

Trust & Safety

Recon operates with read-only access to your repository. No code is stored after the scan completes. All findings remain private to your workspace. SOC 2 compliant. GDPR ready.

Availability

Recon is available on Basic and above. All plans include 3 repository scans per month. Pro unlocks unlimited scans, compliance reporting, and PR auto-generation.

AutoX Brain

AutoX reads your stack, writes production-grade CI/CD pipelines, provisions infrastructure, and handles deployments. It operates like a senior DevOps engineer, automating the entire deployment lifecycle.

Key Capabilities

  • Generating GitHub Actions, GitLab CI, and Bitbucket pipelines from a single prompt
  • Provisioning AWS, GCP, and Azure infrastructure via Terraform end-to-end
  • Configuring OIDC authentication, IAM roles, and security groups automatically
  • Setting up monitoring, alerting, and auto-scaling
  • Triggering rollbacks automatically when deployments fail

How AutoX Works

AutoX's agentic AI handles the complete deployment automation workflow:

  1. Stack Analysis: Reads your codebase to understand languages, frameworks, dependencies, and build requirements
  2. Pipeline Generation: Creates optimized CI/CD pipelines tailored to your tech stack and deployment targets
  3. Infrastructure Provisioning: Generates Terraform configurations and provisions cloud resources
  4. Security Configuration: Sets up OIDC authentication, IAM roles, security groups, and network policies
  5. Deployment Execution: Runs builds, tests, and deployments with health checks and validation
  6. Monitoring & Rollback: Monitors deployment health and triggers automatic rollbacks on failure

Supported Platforms

AutoX integrates with:

CI/CD Platforms:

  • GitHub Actions
  • GitLab CI/CD

Cloud Providers:

  • AWS (full support)
  • Google Cloud Platform (beta)
  • Microsoft Azure (beta)
  • Hetzner - Bare Metal
  • More...

Infrastructure as Code:

  • Terraform
  • CloudFormation
  • Kubernetes manifests

Example Use Cases

CI/CD Pipeline:

"Generate a GitHub Actions pipeline that builds, tests, and deploys my Node.js app to AWS ECS"

Infrastructure Provisioning:

"Provision a production-ready AWS infrastructure with VPC, RDS, ECS, and load balancer using Terraform"

Deployment with Rollback:

"Deploy to production with automatic rollback if error rate exceeds 5%"

Safety & Approval Gates

AutoX requires explicit user approval before any apply or destructive action:

  • Manual approval gates before production deployments
  • Dry-run mode to preview infrastructure changes
  • All infrastructure changes are logged and auditable
  • OIDC-based authentication with no long-lived credentials
  • Automatic rollback on deployment failure

Trust & Safety

AutoX requires explicit user approval before any apply or destructive action. All infrastructure changes are logged. OIDC-based authentication, no long-lived credentials stored anywhere. SOC 2 compliant.

Availability

AutoX is available on Pro and Enterprise plans only. Pro unlocks unlimited pipelines, live deployment tracking, and rollback automation. Enterprise adds dedicated support and custom SLA.