Codex.
The team wiki for the Renkara fleet

A team wiki with a memory for every edit.

Codex keeps your team's documents in spaces, written in Markdown with a live preview. Every save is a version you can compare with the last and restore with one click.

Spaces and pagesTour every screen
Illustration: a dim scriptorium with a stack of plain parchment sheets, a brass inkwell and quill, and one warm brass lamp.
Features

A wiki that keeps every version of every page.

Codex is a FastAPI service on PostgreSQL with a React web client and an MCP server for agents. These are the jobs the web client does today.

Spaces, a page tree, and who can do what

01

Spaces

A space is a top-level home for a team or a subject, with a short key such as RID, a name, a description, an icon, and a visibility of private, internal, or public. The Spaces page has a Create Space form.

02

A page tree

Pages nest under other pages, and the sidebar shows the tree with folders you expand and collapse. Breadcrumbs show where a page sits, and pinned pages carry a pin.

03

Members and roles

A space's settings page lists its members with a role each (admin, editor, commenter, or viewer), and lets an admin add a member, change a role, or remove someone.

04

Status on every page

A page is a draft, published, or archived, and a badge on the page says which. A page mirrored from a git repository says synchronized instead.

Markdown, with the preview beside it

05

A Markdown editor

A title field, a toolbar that inserts Markdown around your selection, the source on the left and the rendered page on the right. It says Unsaved changes until you save, then Saved.

06

Diagrams in the page

A fenced mermaid block renders as a diagram in the page and in the preview. Pages are sanitized before they are shown.

07

Word count and reading time

Every page shows its word count, an estimated reading time, its version number, and when it was last edited.

08

Light and dark

A theme toggle in the top bar switches the whole client between light and dark.

Nothing you saved is lost

09

A version for every save

Each save keeps a snapshot of the title and body with an optional change summary, so the history page lists every version of the page.

10

Compare with the one before

Pick a version and Codex shows a diff against the version before it: what was added, what was removed, and a little context around each change.

11

Restore

Restore any earlier version. It becomes a new save with a summary that says which version it came from, so the history stays whole.

12

Mirror a git repository

A space can be linked to a git repository over SSH. Codex clones it, mirrors the Markdown files as read-only pages, and rewrites relative links between them. Editing a mirrored page sends you back to the repository.

Screens

See it in light and dark

Real captures of the running tool, with fictional StrataForge Robotics data. They follow your theme.

A Codex page from the Autonomous Systems Engineering space: breadcrumbs, a Published badge, star, History, and Edit buttons, the page text, and a panel with word count, reading time, version, and last edited date.A Codex page from the Autonomous Systems Engineering space: breadcrumbs, a Published badge, star, History, and Edit buttons, the page text, and a panel with word count, reading time, version, and last edited date.
A page: breadcrumbs, status, and a panel with the word count, reading time, and version. Enlarge to see the full screen.
Codex's history page for a runbook: five versions with a change summary each and a Restore button, and a diff of the selected version against the one before it.Codex's history page for a runbook: five versions with a change summary each and a Restore button, and a diff of the selected version against the one before it.
History: every version, a diff against the one before, and Restore. Enlarge to see the full screen.
Codex's editor: a title field, a Markdown toolbar, the Markdown source on the left, and the rendered preview on the right.Codex's editor: a title field, a Markdown toolbar, the Markdown source on the left, and the rendered preview on the right.
The editor: Markdown on the left, the preview beside it. Enlarge to see the full screen.
The Robotics Integrity Division space in Codex, with a page tree of folders on the left, two of them expanded, and the space's description and member count.The Robotics Integrity Division space in Codex, with a page tree of folders on the left, two of them expanded, and the space's description and member count.
A space: the page tree on the left, grouped into folders. Enlarge to see the full screen.
Codex's Spaces page listing the eleven StrataForge divisions as space cards, each with its key and description.Codex's Spaces page listing the eleven StrataForge divisions as space cards, each with its key and description.
Spaces: one for each division. Enlarge to see the full screen.
Codex's home page: a welcome heading, a card for each space, and quick links.Codex's home page: a welcome heading, a card for each space, and quick links.
Home: your spaces at a glance. Enlarge to see the full screen.
How it works

From an idea to a page you can trust

  1. Make a space

    Give it a key, a name, and a visibility, and add the people who work in it.

  2. Write pages

    Add pages under folders and write them in Markdown with the preview beside you.

  3. Save as you go

    Every save is a version, with a change summary if you write one.

  4. Compare and restore

    Open the history, read the diff, and restore the version you want.

Accessibility

Built so everyone can use Codex.

Codex's web client has a skip link, labeled form controls, a labeled Markdown editor, and a light and dark theme, and no page overflows sideways at 375 pixels. An axe-core run over every captured view still found violations in all of them, mostly color contrast, and we list them below instead of hiding them. We do not claim a WCAG level.

  • Partly supported

    Keyboard operation

    The client has a skip link to the main content, native buttons, links, and form controls, and the update dialog closes on Escape. No keyboard-only walkthrough of any flow has been recorded, and the history page nests a Restore button inside another button, which axe flags.

  • Partly supported

    Screen reader landmarks and labels

    Search, the editor, the page title field, the star button, the sidebar toggle, and the member form carry accessible names, and one axe test passes on the root screen. The harness run found missing landmarks and headings on some views, and nothing has been tested with a screen reader.

  • Partly supported

    Contrast in light and dark

    Axe still flags color-contrast, a serious violation, on 145 elements across all 14 desktop runs, mostly muted text and accent-colored labels on tinted backgrounds.

  • Partly supported

    Reduced motion

    A prefers-reduced-motion rule covers the update dialog's animation. No other motion in the client has a rule, and no test exercises reduced motion.

  • Not yet tested

    Text resize and zoom

    Resizing text to 200 percent has not been tested.

  • Partly supported

    Mobile and touch

    Seven views fit a 375 by 667 phone screen with no sideways scrolling in both themes. The same run found color-contrast and two scrollable regions that a keyboard cannot focus, and tap-target size was not measured.

Read the accessibility statement and evidence
Tech specs

Under the hood

Codex technical specification
Backend
  • FastAPI on Python, with REST under /api/v1
  • SQLAlchemy 2.0 with async access to PostgreSQL (SQLite for local development and tests)
  • pgvector table for page embeddings
  • Service tokens and JWTs from the fleet identity service
Frontend
  • React 19 and TypeScript, built with Vite
  • Tailwind CSS on the Renkara design system, in light and dark
  • Markdown rendered with marked, sanitized with DOMPurify
  • Diagrams rendered from fenced mermaid blocks
Content
  • Pages in Markdown, nested in a tree
  • A saved version for every edit, with a unified diff
  • Draft, published, and archived pages
  • Read-only mirrors of git repositories
Agents
  • An MCP server at /mcp with 110 tools (Streamable HTTP)
  • Tools call other fleet tools only when a deployment configures them
Testing
  • pytest for the backend, vitest for the web client
  • One vitest-axe smoke test, plus the harness axe-core run listed under Accessibility
Stands in for

Confluence, Notion

Works with

Part of the Renkara fleet

  • Narrative

    An MCP tool publishes a page to a Narrative site, when the deployment sets Narrative's URL and a token.

  • Docket

    MCP tools link a page to a Docket card and search cards, when Docket is configured.

  • Herald

    An MCP tool sends a page as a Herald newsletter, when Herald is configured.

  • Beacon

    MCP tools score a page for search optimization and draft its meta tags, when Beacon is configured.

MCP tools

Built for agents as well as people

Codex's MCP server registers 110 tools, grouped below as they are in the code. The count comes from the code; we have not exercised every tool.

Spaces and members

  • list_spaces
  • create_space
  • get_space
  • update_space
  • delete_space
  • archive_space
  • unarchive_space
  • get_space_tree
  • list_space_members
  • add_space_member
  • update_space_member
  • remove_space_member
  • export_space

Pages and versions

  • list_pages
  • create_page
  • get_page
  • update_page
  • delete_page
  • publish_page
  • unpublish_page
  • move_page
  • reorder_page
  • duplicate_page
  • create_page_from_template
  • list_page_versions
  • get_page_version
  • restore_page_version
  • diff_page_versions
  • list_children

Activity

  • get_page_activity
  • get_space_activity
  • get_global_activity
  • get_page_activity_mcp

Search

  • search_pages
  • search_suggest

Comments

  • list_comments
  • create_comment
  • update_comment
  • delete_comment
  • resolve_comment
  • unresolve_comment

Labels

  • list_labels
  • create_label
  • update_label
  • delete_label
  • add_label_to_page
  • remove_label_from_page

Templates

  • list_templates
  • create_template
  • get_template
  • update_template
  • delete_template

Attachments

  • list_attachments
  • upload_attachment
  • delete_attachment

Stars

  • list_stars
  • star_item
  • unstar_item

Share links

  • list_share_links
  • create_share_link
  • revoke_share_link

Webhooks

  • list_webhooks
  • create_webhook
  • update_webhook
  • delete_webhook

Export and import

  • export_page
  • import_content

Linked repositories

  • list_ssh_keys
  • add_ssh_key
  • delete_ssh_key
  • list_linked_repos
  • create_linked_repo
  • update_linked_repo
  • delete_linked_repo
  • link_repos_bulk
  • sync_linked_repo
  • get_linked_repo_status

Ask Codex and embeddings

  • semantic_search
  • reindex_embeddings
  • ask_codex
  • list_ask_sessions
  • get_ask_session
  • continue_ask_session

Other fleet tools

  • narrative_publish_page
  • narrative_unpublish_page
  • narrative_get_links
  • narrative_list_sites
  • narrative_trigger_build
  • docket_create_link
  • docket_get_links
  • docket_get_backlinks
  • docket_search_cards
  • herald_send_page
  • herald_list_newsletters
  • herald_preview_email
  • beacon_seo_score
  • beacon_generate_meta
  • beacon_keyword_research
  • pulse_get_page_analytics
  • pulse_get_site_stats
  • pulse_get_realtime
  • meridian_log_time
  • meridian_list_projects
  • tribe_get_contact
  • tribe_search_contacts
  • cadence_create_event
  • cadence_list_events
  • vigil_check_status

Service

  • check_service_health
  • get_diagnostics
FAQ

Questions people ask

Is Codex a hosted product I can sign up for?

No. This site describes what the tool does today. Write to contact@renkara.com if you want to talk about it.

What does Codex do?

The web client creates spaces and pages, edits them in Markdown, keeps a version for every save, shows the diff between versions, and restores one.

Who are the people and documents in the screenshots?

They are fictional. The pages come from StrataForge Robotics, a made-up company, in one space for each of its divisions.

Is there a mobile app?

No. The web client fits a phone screen without sideways scrolling, but there is no native app.

Contact

Questions about this tool?

Write to Renkara Media Group and a person will answer.

Email contact@renkara.com