pseudo-js

AI-assisted code generation using stack trace context. Generate JavaScript code on-the-fly by describing what you want in plain English.

Installation

npm install @tluyben/pseudo-js

Setup

Copy .env.example to .env:

cp .env.example .env

Configure your OpenRouter API credentials in .env:

OPENROUTER_API_KEY=your_openrouter_api_key_here
OPENROUTER_MODEL=openai/gpt-4
OPENROUTER_PROVIDER=

Usage

const pseudo = require('@tluyben/pseudo-js');

// Basic usage
const result = await pseudo("calculate the fibonacci number for n=10");

// With arguments
const spaceship = { x: 100, y: 200, velocity: 50 };
const [x, y] = await pseudo("return the point of the spaceship", spaceship);

// Complex operations
const data = [1, 2, 3, 4, 5];
const filtered = await pseudo("filter even numbers and multiply by 2", data);

How it works

Stack Trace Analysis: The function uses the JavaScript stack trace to determine where it was called from
Context Extraction: Reads the source file and extracts 10 lines before and after the call site
AI Generation: Sends the context and specification to OpenRouter's AI models
Code Execution: Executes the generated JavaScript and returns the result

Features

🔍 Context-aware: Uses surrounding code to understand what you're trying to do
🚀 Type-aware: Automatically detects and provides type information for arguments
📝 Natural language: Describe what you want in plain English
⚡ Real-time: Generates and executes code instantly
🔧 Flexible: Works with any JavaScript environment

API

`pseudo(specification, ...args)`

specification (string): Description of what the code should do
...args (any): Optional arguments that the generated code can use
Returns: Promise<any> - The result of executing the generated code

Environment Variables

OPENROUTER_API_KEY (required): Your OpenRouter API key
OPENROUTER_MODEL (optional): Model to use (default: openai/gpt-4)
OPENROUTER_PROVIDER (optional): Specific provider preference

License

MIT