# Work with local filesystem
mdxai agent ./content

# The agent can:
# - Read your existing MDX files
# - Create new files based on patterns
# - Edit files to add/update content
# - Organize files into appropriate directories
# - Maintain consistency across your library

# Work with remote files on .do platform
mdxai agent --remote platform.do

# The agent can:
# - Query MDX files stored on platform.do
# - Edit files directly on the platform
# - Create new content in platform collections
# - Organize and maintain remote content
# - Sync changes between local and remote

# Work with both simultaneously
mdxai agent ./content --remote platform.do

# Agent has access to:
# - Local ./content directory
# - Remote platform.do collections
# - Can sync between them
# - Can reference remote data in local files

pnpm install mdxai

# Export token
export DO_TOKEN="your-api-token-here"

# Or in .env file
echo "DO_TOKEN=your-api-token-here" >> .env

# Now you can access remote files
mdxai agent --remote platform.do

# Login via OAuth
mdxai login

# Opens browser to oauth.do for authentication
# Stores credentials securely
# Now authenticated for all commands

# View current auth status
mdxai whoami

# Logout
mdxai logout

# Switch accounts
mdxai login --account [email protected]

import { mdxai } from 'mdxai'

// With DO_TOKEN
const agent = await mdxai.connect({
  token: process.env.DO_TOKEN,
  remote: 'platform.do',
})

// With OAuth (interactive)
const agent = await mdxai.connect({
  auth: 'oauth',
  remote: 'platform.do',
})

// Now work with remote files
await agent.edit('blog/post.mdx', 'add SEO metadata')

# Login with specific scopes
mdxai login --scope "mdx:read mdx:write collections:read"

# View granted scopes
mdxai whoami --scopes

import { mdxai } from 'mdxai'

// Generate MDX from prompt
const mdx = await mdxai.generate({
  prompt: 'Create a product page for Widget Pro',
  model: 'gpt-5',
  type: 'Product',
})

console.log(mdx)

import { mdxai } from 'mdxai'

// Connect to platform
const agent = await mdxai.connect({
  token: process.env.DO_TOKEN,
  remote: 'platform.do',
})

// Generate and save to platform
await agent.generate({
  prompt: 'Create a product page for Widget Pro',
  collection: 'products',
  type: 'Product',
})

import { mdxai } from 'mdxai'

// Local files
const enhanced = await mdxai.augment(mdxContent, {
  addSEO: true,
  addStructuredData: true,
  addSchema: 'schema.org.ai/Product',
})

// Remote files
const agent = await mdxai.connect({
  token: process.env.DO_TOKEN,
  remote: 'platform.do',
})

await agent.enrich('products/*.mdx', {
  addSEO: true,
  addSchema: 'Product',
})

# Start agent with access to content directory
mdxai agent ./content

# Agent with specific capabilities
mdxai agent ./content --can create,edit,organize

# Watch mode - maintains content automatically
mdxai agent ./content --watch

You: Create a blog post about GraphQL
Agent: I'll create a new blog post. What should I title it?
You: "Introduction to GraphQL"
Agent: Created blog/introduction-to-graphql.mdx
       Added frontmatter with $type: BlogPost
       Added SEO metadata
       Would you like me to add related links?

# Create from prompt
mdxai create "product page for Widget Pro" \
  --type Product --output products/widget-pro.mdx

# Create from template
mdxai create --template blog-post \
  --vars title="Getting Started",author="Jane" \
  --output blog/getting-started.mdx

# Create multiple from list
mdxai create --batch products.csv --template product

# Edit specific file
mdxai edit blog/post.mdx "add a section about performance"

# Edit all files matching pattern
mdxai edit blog/*.mdx "add `published: true` to frontmatter"

# Interactive editing
mdxai edit blog/post.mdx --interactive

# Add SEO to all blog posts
mdxai enrich blog/*.mdx --seo

# Add structured data
mdxai enrich products/*.mdx --schema Product

# Add tags and categories
mdxai enrich docs/*.mdx --categorize --auto-tag

# Add relationships (backlinks, related content)
mdxai enrich ./content --relationships

# Auto-organize by type
mdxai organize ./content --by-type

# Auto-categorize
mdxai organize ./blog --categorize

# Rename files for consistency
mdxai organize ./content --rename-pattern "{slug}.mdx"

# Create index files
mdxai organize ./docs --create-indexes

# Fix broken links
mdxai maintain ./content --fix-links

# Update dates and timestamps
mdxai maintain ./blog --update-dates

# Ensure all required frontmatter exists
mdxai maintain ./content --validate-frontmatter

# Update to latest ontology versions
mdxai maintain ./content --update-schemas

# Show content statistics
mdxai analyze ./content --stats

# Find orphaned documents
mdxai analyze ./content --orphans

# Show relationship graph
mdxai analyze ./content --graph

# Find duplicates
mdxai analyze ./content --duplicates

const article = await mdxai.article({
  topic: 'Getting Started with GraphQL',
  keywords: ['graphql', 'api', 'tutorial'],
  length: 'medium', // short, medium, long
  tone: 'educational',
})

const product = await mdxai.product({
  name: 'Widget Pro',
  features: ['Fast', 'Reliable', 'Scalable'],
  benefits: ['Save time', 'Reduce costs'],
  tone: 'professional',
})

const docs = await mdxai.documentation({
  api: apiSpec,
  sections: ['installation', 'usage', 'examples'],
  includeCodeExamples: true,
})

const service = await mdxai.service({
  name: 'email-sender',
  type: 'Worker',
  description: 'Cloudflare Worker for sending emails',
  endpoints: ['/send', '/verify'],
})

const withSEO = await mdxai.addSEO(mdxContent, {
  generateDescription: true,
  generateKeywords: true,
  generateOgTags: true,
})

const withSchema = await mdxai.addSchema(mdxContent, {
  type: 'Article',
  includeAuthor: true,
  includePublisher: true,
})

const summary = await mdxai.summarize(mdxContent, {
  maxLength: 200,
  style: 'bullet-points',
})

const titles = await mdxai.generateTitles(mdxContent, {
  count: 5,
  style: 'engaging',
})

import { mdxai } from 'mdxai'
import { glob } from 'glob'

// Get all blog posts
const files = await glob('./blog/**/*.mdx')

// Augment all posts
for (const file of files) {
  const content = await fs.readFile(file, 'utf-8')
  const enhanced = await mdxai.augment(content, {
    addSEO: true,
    addSchema: 'BlogPost',
  })
  await fs.writeFile(file, enhanced)
}

import { defineConfig } from 'mdxai'

export default defineConfig({
  // AI model settings
  model: 'gpt-5',
  temperature: 0.7,
  maxTokens: 2000,

  // Default options
  defaults: {
    addSEO: true,
    addSchema: true,
    tone: 'professional',
  },

  // Ontology settings
  ontologies: [
    'schema.org.ai',
    'onet.org.ai',
    'gs1.org.ai',
  ],

  // Output settings
  output: {
    format: 'mdx',
    indent: 2,
    lineWidth: 80,
  },
})

const templates = [
  'blog-post',
  'product-page',
  'landing-page',
  'documentation',
  'api-reference',
  'service-definition',
]

const content = await mdxai.fromTemplate('blog-post', {
  title: 'My Blog Post',
  author: 'Jane Developer',
  date: '2025-10-27',
})

mdxai.registerTemplate('custom', {
  frontmatter: {
    $type: 'CustomType',
    required: ['title', 'author'],
  },
  sections: ['introduction', 'content', 'conclusion'],
  components: ['Callout', 'CodeBlock'],
})

# Login to platform
mdxai login

# Start agent with remote access
mdxai agent --remote platform.do

You: Show me all blog posts on the platform
Agent: Found 247 blog posts in platform.do/blog
       Latest: "Introduction to GraphQL" (2025-10-27)

You: Update all blog posts to add author metadata
Agent: Analyzing 247 posts...
       Added author metadata to 182 posts
       35 posts already had authors
       30 posts need manual review

# Work with both local and remote
mdxai agent ./content --remote platform.do

You: Sync my local blog posts to the platform
Agent: Comparing local ./content/blog with platform.do/blog
       Local: 45 posts
       Remote: 38 posts
       New posts: 7
       Modified posts: 3
       Pushing changes...
       ✓ Synced 10 posts to platform.do

You: Pull latest products from platform
Agent: Pulling products from platform.do
       Found 120 products
       Creating local MDX files in ./content/products
       ✓ Downloaded 120 products

# Edit remote files directly
mdxai agent --remote platform.do

You: Edit platform.do/blog/introduction.mdx
Agent: Opening blog/introduction.mdx from platform...
       Current title: "Introduction"

You: Change title to "Getting Started Guide"
Agent: ✓ Updated title
       ✓ Updated slug: getting-started-guide
       ✓ Updated URL: /blog/getting-started-guide
       ✓ Saved to platform.do

# Reference remote data in local files
mdxai agent ./content --remote platform.do

You: Create a blog post that references products from the platform
Agent: Creating blog post with product references...
       ✓ Created ./content/blog/product-review.mdx
       ✓ Added references to 5 products from platform.do
       ✓ Links will resolve when deployed

# Start agent in watch mode
mdxai agent ./content --watch

# In your terminal or via chat:
You: I need to create 10 blog posts about web development
Agent: I'll create a series of blog posts. Here are my suggestions:
       1. Introduction to Web Development
       2. HTML Fundamentals
       ...
       Should I proceed?
You: Yes, use the blog-post template
Agent: Creating posts...
       ✓ Created blog/introduction-to-web-development.mdx
       ✓ Created blog/html-fundamentals.mdx
       ...
       ✓ Added cross-references between posts
       ✓ Created blog/index.mdx with all posts listed

# Weekly maintenance
mdxai agent ./content

You: Check for content issues
Agent: Analyzing 247 MDX files...
       Found 12 broken links
       Found 8 files missing SEO metadata
       Found 3 orphaned documents
       Would you like me to fix these?
You: Fix the broken links and add SEO
Agent: ✓ Fixed 12 broken links
       ✓ Added SEO to 8 files
       Issues resolved!

# Migrate from WordPress
mdxai agent ./content

You: Import posts from wordpress-export.xml
Agent: Found 150 posts in export file
       Converting to MDX...
       ✓ Converted 150 posts
       ✓ Organized into categories
       ✓ Added $type and $id to all posts
       ✓ Extracted and converted images
       ✓ Created category index files
       Done! Review in ./content/blog

# Generate docs from code
mdxai agent ./docs

You: Generate API docs from ./src
Agent: Analyzing TypeScript files...
       Found 45 exported functions
       Found 23 types
       Creating documentation...
       ✓ Created docs/api/functions/
       ✓ Created docs/api/types/
       ✓ Added code examples
       ✓ Generated docs/api/index.mdx

# Optimize existing content
mdxai agent ./content

You: Optimize all pages for SEO
Agent: Analyzing 89 pages...
       Adding meta descriptions based on content
       Adding OpenGraph tags
       Adding structured data (schema.org)
       ✓ Enriched 89 pages
       Preview: blog/introduction.mdx now has:
         - Meta description (158 chars)
         - OG image and tags
         - Article structured data

# Clean up messy content directory
mdxai agent ./content

You: My content is disorganized. Can you help?
Agent: I'll analyze and organize your content...
       Found:
       - 50 blog posts (mixed locations)
       - 30 products (inconsistent naming)
       - 15 docs (no clear structure)

       Suggested structure:
       ./blog/YYYY/MM/slug.mdx
       ./products/category/slug.mdx
       ./docs/section/topic.mdx

       Should I proceed?
You: Yes
Agent: ✓ Moved 50 blog posts to blog/YYYY/MM/
       ✓ Organized 30 products by category
       ✓ Structured 15 docs by section
       ✓ Created index files for navigation
       ✓ Updated all internal links