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

> Explore the Onyx roadmap and development timeline. Discover priorities including Celery workers, data connectors, RAG search, and enterprise security features on GitHub.

- Repository: [Onyx/onyx](https://github.com/onyx-dot-app/onyx)
- Tags: roadmap
- Published: 2026-03-28

---

**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`](https://github.com/onyx-dot-app/onyx/blob/main/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`](https://github.com/onyx-dot-app/onyx/blob/main/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`](https://github.com/onyx-dot-app/onyx/blob/main/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`](https://github.com/onyx-dot-app/onyx/blob/main/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`](https://github.com/onyx-dot-app/onyx/blob/main/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`](https://github.com/onyx-dot-app/onyx/blob/main/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:

```python
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):

```bash
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`](https://github.com/onyx-dot-app/onyx/blob/main/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`](https://github.com/onyx-dot-app/onyx/blob/main/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`](https://github.com/onyx-dot-app/onyx/blob/main/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`](https://github.com/onyx-dot-app/onyx/blob/main/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.