johnlindquist / johnlindquist/mdflow
feat: URL command inlines - !@https://url syntax
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 604
- Forks
- 43
- PR merge metrics
- No merged PRs in 30d
Description
Summary
Add a command inline syntax that fetches and converts URLs to markdown on-the-fly, complementing the existing !`cmd` syntax with into.md integration.
Proposed Syntax
# Existing command inline (unchanged):
!`git status`
# New URL inline:
!@https://example.com/current-status
# Or explicit into.md call:
!`into https://news.ycombinator.com`
How It Would Work
- Add new pattern:
!@<url>for URL inlines - Fetch URL through into.md API
- Replace inline with converted markdown
- Process at the same time as
!`cmd`inlines insrc/imports.ts
Use Cases
- Live Data Agents:
!@https://status.example.comfor current system status - Research Workflows: Pull in relevant articles/docs dynamically
- Competitive Analysis:
!@https://competitor.com/pricingto inform decisions - News-Aware Agents: Include current headlines in context
Alternative: CLI Helper
Could also expose as a standalone command:
# Standalone usage
into https://example.com > context.md
# Pipe to agent
into https://example.com | ma ANALYZER.md
Implementation Notes
- Add
!@pattern tosrc/imports.ts - Reuse into.md client from URL imports feature
- Consider timeout for slow pages
- Error handling for unreachable URLs
Questions for Discussion
- Is
!@urlintuitive or confusing? Alternatives:!web(url),!fetch(url) - Should we support selectors?
!@https://example.com#main-content - Rate limiting / caching between runs?
Related
This is part of exploring into.md integration opportunities.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start in src/imports.ts and inspect the existing URL imports feature and its into.md client. Trace how !cmd inlines are processed, then determine the scope for handling !@https://url alongside them, including timeout and unreachable-URL behavior. Done means the proposed URL syntax is converted to markdown during processing with the agreed error behavior.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- cli
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100