mrkeyoor.com_
Sat 17 Oct 13:31 UTC
Self-Hostedevaluationupdated 14 Oct 2026

slashdocs review

Slashdocs is a self-hosted document workspace where agents publish HTML reports and people review them in a browser. Comments attach to passages, and agents can publish revisions while older versions remain available.

+93 / 2dstars / 7d
Verdict

Our Slashdocs run built successfully in 76 seconds, but its test command failed after 18 seconds with failures in CLI and document-rendering checks. Trial it for agent-generated HTML reports that desktop reviewers can comment on, with checks around comment placement and rendering isolation. Wait if phone-based version review or identity-provider migration is central to your rollout.

We ran it

Lab card: what happened when we ran slashdocsScreenshot of slashdocs (tryslashdocs.razorpay.com)
Install✓ · 42s245 packages
Build✓ · 76s
Tests✗ · 18s24 passed · 5 failed of 29 (go test)
Repo472 files~66,644 lines of source · 4.5 MB · 2 CI workflows · Dockerfile

Answers from our run

Does slashdocs build from source?

Dependencies installed in 42 seconds (245 packages), and the build succeeded in 76 seconds. We cloned commit d4f5c29 into a clean Debian container with 3 CPUs and no project-specific setup.

Do slashdocs's tests pass?

No. The project's own test command finished in 18 seconds and reported 24 passed, 5 failed (go test).

Who should not use slashdocs?

Operators unable to provide separate app and render hostnames: the README requires that boundary for uploaded HTML, and a different port is insufficient.

What are the alternatives to slashdocs?

Outline, Docmost, HedgeDoc. Our Slashdocs run built successfully in 76 seconds, but its test command failed after 18 seconds with failures in CLI and document-rendering checks.

Setup3/5Build passed; production needs storage, OIDC, and separate hostnames
Docs4/5Detailed deployment, origin-isolation, CLI, and MCP guidance
Community3/5280 stars, October 14 push, and active issue and PR work
Maturity2/5v0.2.1 is active; failed bridge checks and review defects need attention

Who it’s for

Teams whose agents already generate HTML reports, specs, or incident write-ups.
Desktop reviewers who need comments on specific passages and retained document versions.
Operators able to provide database, object storage, identity, and separate rendering infrastructure.
MCP and Claude Code users who want automated publishing connected to human review.

Who it’s NOT for

Operators unable to provide separate app and render hostnames: the README requires that boundary for uploaded HTML, and a different port is insufficient.
Teams depending on phone-based version review: open issue 202 reports unreachable version history on narrow screens in v0.2.1.
Agents that need an accepted comment to guarantee correct placement: issue 198 reports nonexistent or ambiguous quotes accepted as attached in v0.2.1 code.
Teams expecting painless identity-provider URL changes: issue 203 reports existing-user lockouts after generic OIDC issuer changes and cites v0.2.1 code.

Setup reality

Our sandbox installed commit d4f5c29 in 42 seconds, fetching 245 packages, and built it in 76 seconds. Tests failed with exit code 1 after 18 seconds, with the supplied summary reporting 24 passed and 5 failed out of 29. The tail names more bridge failures than that summary and lacks assertion details, so their cause and the discrepancy remain unresolved.

The Compose evaluation stack includes Postgres, S3-compatible storage, and a development Dex login. Production needs its own identity provider and credentials, storage configuration, session secrets, and HTTPS. Agents use browser OAuth or service-account keys.

App and document rendering must use different hostnames. The README directs server source work through make build-backend to regenerate and fingerprint the iframe bridge, and local container changes need Buildx. Our successful build does not establish that the complete deployed review workflow passed.

An agent report becomes a document people can review

Slashdocs built in 76 seconds in our sandbox, but its useful promise starts after compilation: an agent publishes an HTML report, a person comments on a specific passage, and the agent publishes a revised version. The old version stays available. That gives a team somewhere to discuss generated work without losing the report and its corrections in a chat history.

The project README makes a self-contained HTML file the document unit. Images can be embedded, and diagrams can use inline SVG or Mermaid. That's convenient for an agent that already emits an architecture review or incident report as an artifact. You still own the substance of that report. Slashdocs provides review and version storage, without establishing that an agent's claims are correct.

What happened when we ran it

Our run installed Slashdocs commit d4f5c29 in 42 seconds, fetching 245 packages, and built it successfully in 76 seconds. We cloned it on October 14, 2026, into a fresh Debian sandbox using golang:1.24-bookworm, with 3 CPUs and 8 GB of RAM. The container had no secrets or elevated privileges. These results establish that the measured source path installed and compiled in that environment.

The test command failed with exit code 1 after 18 seconds. The supplied Go summary reports 24 passed and 5 failed out of 29. Its tail shows failures in cli/internal/cli and internal/render. Named bridge checks concern theme behavior, the postMessage security boundary, message families, document links, the manual-edit contract, and stored document values with undo and redo. Those names describe the checks that failed, without showing their assertion messages.

The supplied summary's 5 failures do not match the larger list of named bridge failures in the tail. We preserve the summary as reported and flag that discrepancy instead of manufacturing a reconciled total. The excerpt also doesn't show why those contracts failed. In particular, a failing security-boundary check is a reason to investigate before deployment, not evidence from this log that uploaded HTML can escape its sandbox.

The checkout contained 472 files, roughly 66,644 lines of source, and occupied 4.5 MB. Our scan found 2 CI workflow files, a Dockerfile, and a Compose file, but no tests directory. The log plainly shows Go checks in package directories. Our measurement method covered source installation, build, and tests. It did not exercise an authenticated deployment or validate the browser's isolation of a hostile document.

The quickstart supplies services that production must replace

The 42-second dependency step doesn't include production identity and storage configuration. The bundled Compose route starts Postgres, an S3-compatible service, and Dex with a development login. The README distinguishes that evaluation stack from a real deployment and offers a published container image. To change the container locally, it documents Compose with Buildx. Those routes are useful, but aren't outcomes from our sandbox run.

Production needs Postgres, an S3-compatible bucket, identity-provider credentials, session secrets, and HTTPS. The self-hosting guide requires different hostnames for the application and rendered documents. Changing only the scheme or port doesn't isolate host-scoped cookies. I'd stop an adoption that cannot provide that separation: the product intentionally accepts untrusted HTML, so the render hostname belongs in the deployment design from the beginning.

MCP avoids a local bridge, while agent access still needs credentials

Slashdocs exposes Streamable HTTP at /mcp, with browser OAuth for interactive clients and service-account bearer keys for unattended agents. The endpoint covers document versions, comments, sharing, and folders. The CLI also installs a bundled skill into agent and Claude Code skill directories. That is a practical fit when a team wants its existing agents to publish artifacts into the same place humans review them.

The README keeps creation of service accounts and bearer keys outside MCP, directing administrators to the web application or CLI. New documents are private by default, with configurable sharing defaults. Choose the agent's access deliberately before connecting it to a workspace. The 24 passing tests in our supplied summary don't prove that an automated publisher has the right permissions for your organization's documents, or that its generated HTML deserves those permissions.

Current reports question comment placement and phone access

Open issue 198 on anchor validation cites v0.2.1 code where a nonexistent or ambiguous quote can be accepted as an attached comment. The report distinguishes this from comments drifting after a later edit. That difference matters: an agent can receive apparent success for feedback the viewer cannot place. PR 209 proposes validation, but it was still open. I'd check placement in the browser before treating the comment response as confirmation.

Open issue 202 on phone-width version history also cites v0.2.1: the history button disappears on narrow screens without a menu alternative. A proposed fix in PR 208 remained open. Teams whose reviewers regularly use phones should wait or verify a fix themselves. These are upstream reports, separate from our 18-second failed test command. They concern the review workflow people would buy into, rather than cosmetic details.

October releases justify evaluation, with identity migration needing care

The repository was pushed on October 14, 2026. GitHub listed 280 stars and 39 open issues and PRs, and release v0.2.1 shipped on October 13. Current work includes a merged notification-name fix and proposed review-interface changes. This is an active project with a small visible audience. The release and push dates support evaluation, while the open reports show where to spend that evaluation effort.

Issue 203 on OIDC issuer changes reports existing-user lockouts after the issuer URL changes and ties the behavior to v0.2.1 identity code. Keep that migration concern in the decision alongside the failed bridge checks. I'd trial Slashdocs for agent-generated HTML reports with desktop reviewers. Choose Outline or Docmost for a wiki-centered team, or HedgeDoc for shared Markdown writing. Adopt Slashdocs after its exact review and recovery paths work for your team.

Alternatives

ProjectWhat it isPick it when
Outline gh↗A collaborative team knowledge base with Markdown support.pick this instead when a team knowledge base is the main requirement rather than reviewing agent-published HTML artifacts.
Docmost gh↗An open-source collaborative wiki and documentation application.pick this instead when people primarily author and organize wiki pages together.
HedgeDocA workspace for collaborative Markdown documents.pick this instead when shared Markdown writing is more useful than uploading self-contained HTML.

What people are saying

  1. [github-trending] razorpay/slashdocs
  2. [producthunt] SlashDocs by Razorpay

Sources

  1. Slashdocs README
  2. Slashdocs self-hosting guide
  3. Slashdocs v0.2.1 release
  4. Comment anchor validation report
  5. Phone-width version history report
  6. OIDC issuer migration report
  7. Slashdocs repository facts
  8. CLI agent skill installation at measured revision

More self-hosted reviews

playport · edge-smart-doh · Comma · ProsperoEden · zulu · node_exporter · the whole board →