https://github.com/dcchuck/tsexpress
The Typescript web framework that puts Agents first. Simple like Express. Agent first like the future.
https://github.com/dcchuck/tsexpress
agent-friendly ai ai-agents api automation backend express framework llm nodejs open-source starter typescript
Last synced: 1 day ago
JSON representation
The Typescript web framework that puts Agents first. Simple like Express. Agent first like the future.
- Host: GitHub
- URL: https://github.com/dcchuck/tsexpress
- Owner: dcchuck
- Created: 2026-04-02T01:40:01.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-02T03:24:57.000Z (about 2 months ago)
- Last Synced: 2026-04-02T16:44:05.320Z (about 2 months ago)
- Topics: agent-friendly, ai, ai-agents, api, automation, backend, express, framework, llm, nodejs, open-source, starter, typescript
- Homepage:
- Size: 4.88 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
README
# tsexpress
TypeScript-first web framework design inspired by Express.
## Why This Exists
Express got something important right: web servers should be easy to read, easy to compose, and close to Node's native HTTP model. `tsexpress` exists to keep that feel while taking TypeScript seriously from the beginning.
This project is not trying to build a giant meta-framework. The goal is a small, understandable framework that feels like Express, but treats types and contracts as first-class parts of the design.
## Project Vision
`tsexpress` should feel familiar to anyone who has used Express:
- app and router based composition
- `req`, `res`, and `next`
- middleware chains and error middleware
- simple route registration on top of Node `http`
The difference is that `tsexpress` should champion TypeScript-first development:
- route contracts are part of route declarations
- TypeScript should infer as much as possible from those contracts
- runtime behavior and type behavior should stay aligned
Agent-friendly introspection matters, but it is downstream of the framework itself. First it must be a strong web framework. Then it can expose metadata that makes applications and deployments easier for agents to inspect.
## Design Principles
- Feel like Express from the first read.
- Stay close to Node's `http` runtime model.
- Keep abstractions small and obvious.
- Treat contracts and types as part of the framework, not optional garnish.
- Require tests for meaningful behavior changes.
- Build agent-friendly introspection without warping the API around it.
## Why Contribute Early
This project is starting from zero. Early contributors have a real chance to shape the framework, influence its conventions, and leave visible fingerprints on its foundation.
That applies to both human contributors and AI-assisted contributors. Strong early work will be easy to attribute because the project is still defining its defaults, style, and architecture.
## Initial Focus
The first wave of work is about building a serious foundation:
- clear project docs and contribution guidance
- repository scaffolding for a small TypeScript library
- framework primitives like app creation, routers, middleware, and response helpers
- contract-driven typing
- internal introspection for future agent-friendly tooling
## Contributing
See [CONTRIBUTING.md](./CONTRIBUTING.md) for contribution standards and workflow expectations.