What Is the Roadmap for Onyx? Current Priorities and Development Timeline

The roadmap for Onyx is publicly maintained on a GitHub Projects board at https://github.com/orgs/onyx-dot-app/projects/2, detailing active development across Celery background workers, data connectors, RAG search enhancements, and enterprise security features.

The onyx-dot-app/onyx repository operates on a transparent development schedule that guides its evolution from an open-source search tool to a comprehensive enterprise AI platform. Understanding the roadmap for Onyx helps contributors and users anticipate architectural changes before they land in main. The planning document is tightly integrated with the codebase, with progress tracked publicly and linked directly from the repository’s primary documentation.

Where to Find the Official Roadmap for Onyx

The canonical roadmap for Onyx lives in GitHub Projects board #2, accessible at https://github.com/orgs/onyx-dot-app/projects/2. According to the repository’s README.md around lines 88-90, this board serves as the single source of truth for upcoming releases. The board is organized into columns such as Backlog, In Progress, and Done, allowing anyone to monitor the status of specific features without cloning the repository.

Maintainers update the board continuously, moving items as code changes are merged into directories like backend/onyx/background/celery/tasks/ or web/src/app/.

How the Roadmap Maps to Onyx’s Architecture

The roadmap for Onya drives development across five distinct architectural zones, each mapped to concrete source locations.

Background Workers and Celery Tasks

Items targeting asynchronous processing are implemented in backend/onyx/background/celery/tasks/. The roadmap typically tracks new worker types, task-prioritization improvements, and expiration handling mechanisms. These components are described architecturally in AGENTS.md around line 23.

Connector Ecosystem Expansions

New data-source integrations, OAuth support, and batch-sync optimizations appear in the roadmap’s connector section. These features extend the ingestion layer outlined in AGENTS.md near line 51.

RAG and Search Enhancements

Hybrid-search improvements, Knowledge Graph clustering, and Vespa performance tweaks dominate this category. The RAG architecture section in AGENTS.md (around line 50) defines how these roadmap items alter the retrieval pipeline.

Frontend and UI Evolution

React-based improvements for agents, chat sharing, and admin panels target the web/src/app/ directory. These roadmap items align with the frontend stack description in AGENTS.md around line 38.

Enterprise and Security Features

Role-based access control (RBAC) refinements, SSO (OIDC/SAML) upgrades, and multi-tenant scheduling are tracked for the Enterprise Edition. The architecture overview in AGENTS.md near line 21 governs these security enhancements.

Programmatic Access to the Onyx Roadmap

Developers can query the roadmap for Onyx programmatically using GitHub’s APIs, enabling automation for internal planning tools.

Querying with the GitHub GraphQL API

The following Python script retrieves the first 20 items from project #2, filtering for issue content and state:

import requests, os, json

GITHUB_TOKEN = os.getenv("GITHUB_TOKEN")  # personal access token

QUERY = """
{
  organization(login: "onyx-dot-app") {
    projectV2(number: 2) {
      title
      items(first: 20) {
        nodes {
          content {
            ... on Issue {
              title
              url
              state
            }
          }
        }
      }
    }
  }
}
"""

headers = {"Authorization": f"Bearer {GITHUB_TOKEN}"}
resp = requests.post(
    "https://api.github.com/graphql",
    json={"query": QUERY},
    headers=headers,
)
data = resp.json()
for item in data["data"]["organization"]["projectV2"]["items"]["nodes"]:
    issue = item["content"]
    print(f"{issue['state']}: {issue['title']} – {issue['url']}")

Using the REST API with curl

Alternatively, retrieve project columns via the REST API (requires a token with repo scope):

curl -H "Authorization: token $GITHUB_TOKEN" \
     -H "Accept: application/vnd.github.inertia-preview+json" \
     "https://api.github.com/projects/2/columns"

Summary

• The roadmap for Onyx is hosted at https://github.com/orgs/onyx-dot-app/projects/2 and linked from README.md lines 88-90.
• Development spans Celery workers (backend/onyx/background/celery/tasks/), connector ecosystems, RAG systems, and the React frontend (web/src/app/).
• Architectural decisions are documented in AGENTS.md, with specific line references for workers (l.23), connectors (l.51), and frontend (l.38).
• GitHub’s GraphQL and REST APIs allow programmatic monitoring of roadmap progress without manual browser checks.

Frequently Asked Questions

Where is the official roadmap for Onyx published?

The official roadmap is published on the Onyx GitHub Projects board at https://github.com/orgs/onyx-dot-app/projects/2. This board is referenced in the repository’s README.md file around lines 88-90 and is maintained collaboratively by the core team and community contributors.

How does the roadmap for Onyx relate to the actual codebase?

Each roadmap item maps to specific directories such as backend/onyx/background/celery/tasks/ for background workers, web/src/app/ for frontend changes, and the connector ecosystem described in AGENTS.md. When an item moves to "In Progress," corresponding code changes appear in these target locations.

Can I contribute to features listed on the Onyx roadmap?

Yes, the open Projects board allows contributors to see which architectural components—such as Celery tasks, FastAPI endpoints, or React components—are slated for changes. You can submit PRs targeting these areas as outlined in the roadmap, even before official implementation begins.

What types of features are typically prioritized on the roadmap?

Priorities include new Celery worker types and task prioritization for background processing, connector ecosystem expansions for data ingestion, RAG and Knowledge Graph improvements for search relevance, and enterprise features like RBAC and SSO upgrades for multi-tenant deployments.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}