Add AGENTS.md with Cursor Cloud development instructions#6
Conversation
Co-authored-by: Alex <aavramch@users.noreply.github.com>
📝 WalkthroughWalkthroughAdded ChangesAgent Instructions
🎯 1 (Trivial) | ⏱️ ~3 minutes
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Comment |
Deploying with
|
| Status | Name | Latest Commit | Updated (UTC) |
|---|---|---|---|
| 🚫 Deployment cancelled View logs |
reparsed | c2bc177 | May 23 2026, 06:39 AM |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@AGENTS.md`:
- Around line 12-23: The two fenced code blocks in AGENTS.md (the one containing
"sudo pg_ctlcluster 16 main start" and the multi-line uvicorn/DATABASE_URL
block) lack surrounding blank lines and language identifiers; update each fenced
block to have a blank line before and after and add the appropriate language tag
(e.g., ```bash) so the pg_ctlcluster single-line block and the uvicorn
environment/command block are fenced as ```bash with blank-line spacing around
them.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
| ``` | ||
| sudo pg_ctlcluster 16 main start | ||
| ``` | ||
|
|
||
| 2. **Start FastAPI with uvicorn** from the `api/` directory: | ||
| ``` | ||
| DATABASE_URL="postgresql+asyncpg://reparsed:reparsed@localhost:5432/reparsed" \ | ||
| SESSION_SECRET="dev-secret-for-local-testing-only-32b" \ | ||
| OLLAMA_BASE_URL="http://localhost:11434" \ | ||
| PLAYWRIGHT_ENABLED=false \ | ||
| uvicorn app.main:app --host 0.0.0.0 --port 17177 --reload | ||
| ``` |
There was a problem hiding this comment.
Add Markdown fence languages and blank-line spacing around fenced blocks.
The fenced blocks on Line 12 and Line 17 violate MD031/MD040. Add surrounding blank lines and explicit language identifiers.
📄 Proposed doc fix
1 # AGENTS.md
2
3 ## Cursor Cloud specific instructions
4
5 ### Overview
6
7 Reparsed is a single-service Python 3.12 FastAPI application that parses files and URLs into clean, structured, LLM-ready text. It requires PostgreSQL 16 for persistence and optionally connects to an external Ollama server for LLM classification.
8
9 ### Running the dev server
10
11 1. **Start PostgreSQL** (if not already running):
-12 ```
+12
+ ```bash
13 sudo pg_ctlcluster 16 main start
14 ```
15
16 2. **Start FastAPI with uvicorn** from the `api/` directory:
-17 ```
+17
+ ```bash
18 DATABASE_URL="postgresql+asyncpg://reparsed:reparsed@localhost:5432/reparsed" \
19 SESSION_SECRET="dev-secret-for-local-testing-only-32b" \
20 OLLAMA_BASE_URL="http://localhost:11434" \
21 PLAYWRIGHT_ENABLED=false \
22 uvicorn app.main:app --host 0.0.0.0 --port 17177 --reload
23 ```🧰 Tools
🪛 markdownlint-cli2 (0.22.1)
[warning] 12-12: Fenced code blocks should be surrounded by blank lines
(MD031, blanks-around-fences)
[warning] 12-12: Fenced code blocks should have a language specified
(MD040, fenced-code-language)
[warning] 17-17: Fenced code blocks should be surrounded by blank lines
(MD031, blanks-around-fences)
[warning] 17-17: Fenced code blocks should have a language specified
(MD040, fenced-code-language)
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@AGENTS.md` around lines 12 - 23, The two fenced code blocks in AGENTS.md (the
one containing "sudo pg_ctlcluster 16 main start" and the multi-line
uvicorn/DATABASE_URL block) lack surrounding blank lines and language
identifiers; update each fenced block to have a blank line before and after and
add the appropriate language tag (e.g., ```bash) so the pg_ctlcluster
single-line block and the uvicorn environment/command block are fenced as
```bash with blank-line spacing around them.
2 participants
Summary
Adds
AGENTS.mdwith Cursor Cloud-specific development instructions so future cloud agents can quickly set up and run the Reparsed API locally.What's included
Development environment verification
The full development environment was set up and verified end-to-end:
reparseduser/databaserequirements.txtDemo
demo_reparsed_registration_and_dashboard.mp4
End-to-end flow: landing page, registration, dashboard, API key generation.
Landing page
Dashboard with API key
API tests
All core endpoints verified:
GET /healthz— 200 OKGET /v1/health— returns model statusGET /v1/content-types— lists all content typesPOST /register— user registrationPOST /dashboard/api/keys— API key generationPOST /v1/parse— text parsing with graceful LLM fallbackTo show artifacts inline, enable in settings.
Summary by CodeRabbit