v0.1.1 · CLI MVP · MIT · Local-first

DevDocs Forge Agent

Turn tutorial transcripts into beautiful developer documentation.

Local-first AI docs agent for developers, DevRel teams, and course creators. No scraping. No lock-in. Bring your own model key.

Run it now →View source

🖥️ Runs locally from your terminal

This website is documentation only. Clone the repo, add your transcript, and generate docs from your terminal — no account required.

No hosted generatorNo transcript scrapingNo account requiredMock mode works offline

devdocs-forge-agent generate

INPUT

📄angular-signals-tutorial.md

mode: docusaurus · 2,841 words

AGENT

✓Video Intake Guard: passed

✓Prompt built for docusaurus

✓Generating with mock provider

✓Writing output files

OUTPUT

✓Documentation generated!

output/angular-signals-tutorial-2026-05-13/

5 files · ready to review

⚖️MIT License

✅82 tests passing

🚫No YouTube scraping

🤖4 AI providers

🖥️Local-first

📦TypeScript strict mode

Try it now

Up and running in 60 seconds.

Mock mode ships built-in — no API key required to generate your first doc.

npm run demo

$git clone https://github.com/AnkitParekh007/devdocs-forge-agent.git

$cd devdocs-forge-agent && npm install && cp .env.example .env

$npm run demo

OK Node.js v22 > 18 required

OK provider: mock no API key needed

🛡️ Video Intake Guard: enabled

Generating with provider: mock · mode: docusaurus

✓ Documentation generated successfully!

Output: output/angular-signals-tutorial-2026-05-13/

How it works

A five-stage documentation pipeline.

Each stage is independently testable. The Intake Guard blocks non-technical content before any tokens are consumed.

📄

Your Transcript

.md · .txt · .vtt

→

🛡️

Intake Guard

URL + tech classification

→

⚡

Prompt Builder

Mode-specific templates

→

🤖

AI Provider

OpenAI · Anthropic · Gemini

→

📂

Output Writer

5 files per run

Transform

Transcript in. Developer docs out.

Turn messy learning material into structured docs developers can search, review, commit, and improve.

Before

● Tutorial transcript
● Product demo notes
● Course lesson recording
● Internal walkthrough
● Raw technical notes

→

After

✓ Docusaurus documentation page
✓ GitBook-friendly guide
✓ README tutorial
✓ Blog post
✓ FAQ document
✓ Troubleshooting guide
✓ SEO metadata
✓ metadata.json + review-checklist.md

Videos are great for learning. Docs are great for shipping.

Most technical knowledge gets trapped inside tutorial videos, product demos, meeting recordings, and course lessons — making it hard to search, review, version, or reuse.

DevDocs Forge Agent converts that raw learning material into reviewable, version-controlled developer documentation. Source attribution, human review checklists, and safe local-first workflows built in. It creates a strong first draft. You review and publish.

Features

Everything you need. Nothing you don't.

Built for developers who want clean documentation tooling — local, fast, and fully controllable.

🖥️

Local-first

Runs entirely on your machine. No cloud backend, no data leaving your environment.

🔑

Bring your own key

OpenAI, Anthropic, or Gemini. Swap providers with one env var change.

🎭

Mock mode

Full output in mock mode — no API key needed for development and demos.

📄

Markdown-first

Every output is plain Markdown. Drop directly into any docs system.

🦕

Docusaurus-ready

Generates correct YAML frontmatter, sidebar config, and admonition syntax.

📚

GitBook-ready

GitBook hint blocks, page structure, and navigation hints included.

🛡️

Video Intake Guard

Validates video URLs, classifies tech content, blocks non-technical or scraped content.

🚫

No scraping

devdocs-forge-agent never scrapes YouTube. You always provide your own transcript.

✅

Human review checklist

Every run generates a checklist to review before publishing.

🔌

Easy to extend

Add a provider in ~60 lines. Add a mode with zero TypeScript.

AI Providers

Your model. Your API key.

Switch providers with one line. No SDK packages — pure native fetch throughout.

Mock

Default · Free

Generates structured output with no API key.

Best for: development, CI/CD, demos.

DEVDOCS_PROVIDER=mock

OpenAI

API key required

GPT-4.1-mini for fast docs. GPT-4.1 for highest quality.

Best for: cost-efficient bulk generation.

DEVDOCS_PROVIDER=openai
OPENAI_API_KEY=sk-...

Anthropic

API key required

Claude 3.5 Sonnet for best-in-class technical writing.

Best for: high-quality, nuanced docs.

DEVDOCS_PROVIDER=anthropic
ANTHROPIC_API_KEY=sk-ant-...

Gemini

API key required

Gemini 2.0 Flash for fast, cost-effective generation at scale.

Best for: large batches and multimodal inputs.

DEVDOCS_PROVIDER=gemini
GEMINI_API_KEY=...

Safety

Video Intake Guard

When you provide a video URL, three checks run automatically before any generation starts.

1
URL Validation
Only YouTube and Vimeo URLs are accepted. Malformed or unsupported URLs are rejected immediately.
2
Tech Video Classification
Scores the video's title, description, tags, and category (0–100). Score < 35 blocks generation unless --force is set.
3
Transcript Requirement
You must always provide --file with your own transcript. URL-only generation is blocked by design.

devdocs-forge-agent never

Scrapes YouTube transcripts or captions
Downloads video files or audio
Accesses YouTube captions API
Auto-fetches transcript text from any URL
Generates docs without a user-provided file

Video URL flow

Test with a YouTube URL safely.

Use the URL for metadata and validation only. DevDocs Forge Agent never scrapes transcripts or downloads videos.

Step 1 — Inspect a video URL (no transcript needed)

$npm run devdocs-forge-agent -- inspect-url "https://www.youtube.com/watch?v=W6NZfCO5SIk"

Step 2 — Validate URL + transcript together

$npm run devdocs-forge-agent -- validate-source \ --url "https://www.youtube.com/watch?v=W6NZfCO5SIk" \ --file input/my-transcript.md

Step 3 — Generate docs with the Intake Guard

$npm run generate -- \ --url "https://www.youtube.com/watch?v=W6NZfCO5SIk" \ --file input/my-transcript.md \ --type docusaurus

URL-only generation is blocked by design. You must provide a transcript file you own or have permission to use. DevDocs Forge Agent never auto-fetches transcript text from any URL.

Output

Every run. Five files.

Generated docs land in a timestamped folder — ready to review, commit, or publish.

output/angular-signals-tutorial-2026-05-13/

output/

angular-signals-tutorial-2026-05-13/

index.md

metadata.json

review-checklist.md

source-summary.md

docs/

angular-signals-tutorial.md

← Docusaurus-ready

index.md

Main generated documentation — full content ready to review and publish.

metadata.json

Provider, model, word count, source URL, and generation timestamp.

review-checklist.md

Human review checklist: verify facts, test code, check attribution.

source-summary.md

Source word count, slug, detected title, and source URL.

docs/{slug}.md

Docusaurus-ready copy with YAML frontmatter and sidebar config.

docs/angular-signals-tutorial.md

---

id: angular-signals-tutorial

title: Angular Signals Tutorial

sidebar_label: Angular Signals

sidebar_position: 1

description: A comprehensive guide to Angular's signals API...

---

# Angular Signals: Reactive State Without Complexity

Angular 16 introduced signals as a new reactive primitive. Unlike RxJS observables, signals are synchronous, fine-grained, and require no subscription management.

## Prerequisites

- Angular 16+ project

- Basic TypeScript knowledge

## Creating a signal

```typescript

import { signal } from '@angular/core';

const count = signal(0);

```

···

Who it's for

Built for people who turn technical knowledge into reusable docs.

🎬

Developer YouTubers

Turn tutorial recordings into Docusaurus sites.

📣

DevRel teams

Convert demo recordings into onboarding docs.

🎓

Course creators

Generate lesson pages from lecture notes.

🔧

Open-source maintainers

Create READMEs and guides from issue walkthroughs.

🏢

Engineering teams

Generate internal runbooks from Loom transcripts.

✍️

Technical bloggers

Draft dev.to posts from talk notes.

Fork it. Make it yours.

devdocs-forge-agent is MIT licensed and designed to be extended. Add a provider in ~60 lines of TypeScript. Add a new output mode with zero TypeScript. 5 good-first issues are open and waiting.

Add a providerAdd a modeImprove promptsAdd examplesImprove docsBuild the UI

Good first issues →Contributing guide

⭐

If this saves you documentation time, star the repo.

More stars help more developers find DevDocs Forge Agent. It takes 2 seconds and helps the project grow.

⭐ Star on GitHub