{"id":42082,"library":"telos-framework","title":"Telos Framework","description":"Telos Framework (v0.10.1) is a philosophically-grounded multi-agent development framework that enforces spec-driven development in AI-assisted coding. It embeds a four-level purpose hierarchy (Purpose, Experience, Contract, Function) and uses `@telos` annotations to link every function to requirements. The CLI detects AI coding platforms (Claude Code, OpenCode, Cursor, etc.) and installs slash commands like `/telos:init`, `/telos:validate`, and `/telos:sdd-discover`. It is released under MIT, requires Node >=16, and is actively maintained with weekly releases on npm.","status":"active","version":"0.10.1","language":"javascript","source_language":"en","source_url":"https://github.com/telos-framework/init","tags":["javascript","ai","agents","development","telos","philosophy","multi-agent","spec-driven","openspec"],"install":[{"cmd":"npm install telos-framework","lang":"bash","label":"npm"},{"cmd":"yarn add telos-framework","lang":"bash","label":"yarn"},{"cmd":"pnpm add telos-framework","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"Package is primarily a CLI tool; use npx to run without installing globally.","wrong":"npm install -g telos-framework (not intended for global install)","symbol":"telos-framework (CLI)","correct":"npx telos-framework init"},{"note":"Commands are slash commands inside AI coding assistants (Claude Code, Cursor, etc.), not terminal commands.","wrong":"(no common wrong pattern)","symbol":"/telos:* commands","correct":"/telos:init in AI assistant"},{"note":"Annotation must follow the pattern: L{level}:{type}:{path}:{name} with colons separating segments.","wrong":"/* @telos L1:function:validateToken */ (missing path)","symbol":"@telos annotation","correct":"// @telos L1:function:src/auth/validation:validateToken"}],"quickstart":{"code":"npx telos-framework init","lang":"javascript","description":"Creates a new project with spec-driven development structure and installs AI assistant slash commands. Run inside your project directory."},"warnings":[{"fix":"Use the exact format: `// @telos L1:function:src/file.ts:functionName`","message":"`@telos` annotation format is strict: `L{level}:{type}:{path}:{name}`. Missing or extra colons break spec linking.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Open your project in a supported AI coding assistant before running slash commands.","message":"Slash commands only work in supported AI coding assistants (Claude Code, OpenCode, Cursor). Not available in generic terminals or chat UIs.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Use `npx telos-framework` instead of `npx telos`.","message":"Version 0.10.0 changed the CLI entry point from `telos` to `telos-framework`. `npx telos` no longer works.","severity":"breaking","affected_versions":">=0.10.0"},{"fix":"Use `@telos` alone (without colon) as the annotation prefix.","message":"The legacy `@telos:init` annotation (with colon) is deprecated as of v0.9.0.","severity":"deprecated","affected_versions":">=0.9.0"},{"fix":"After `npx telos-framework init`, run `/telos:sdd-discover` in your AI assistant to generate specs from existing code.","message":"Brownfield projects (existing codebases) require an additional `/telos:sdd-discover` step after init, or spec generation will be skipped.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Upgrade Node.js to version 16 or later.","message":"The framework requires Node.js >=16.0.0. Older versions will fail to install or run.","severity":"gotcha","affected_versions":">=0.1.0"}],"env_vars":null,"search_vec":"'/telos':65,67,70 '16':81 'activ':84 'agent':13,93,99 'ai':24,52,92 'ai-assist':23 'annot':42 'assist':25 'claud':55 'cli':50 'code':26,53,56 'command':63 'contract':37 'cursor':58 'detect':51 'develop':14,21,94 'discov':73 'driven':20,102 'emb':28 'enforc':17 'etc':59 'everi':45 'experi':36 'four':31 'four-level':30 'framework':2,4,15 'function':38,46 'ground':10 'hierarchi':34 'init':66 'instal':61 'javascript':91 'level':32 'like':64 'link':44 'maintain':85 'mit':78 'multi':12,98 'multi-ag':11,97 'node':80 'npm':90 'opencod':57 'openspec':103 'philosoph':9 'philosophi':96 'philosophically-ground':8 'platform':54 'purpos':33,35 'releas':76,88 'requir':48,79 'sdd':72 'sdd-discov':71 'slash':62 'spec':19,101 'spec-driven':18,100 'telo':1,3,41,95 'use':40 'v0.10.1':5 'valid':68 'week':87","created_at":"2026-06-04T18:55:31.912358+00:00","updated_at":"2026-06-04T18:55:31.912358+00:00","problems":[{"fix":"Run `npx telos-framework init` instead.","cause":"Using `npx telos` instead of `npx telos-framework` (changed in v0.10.0).","error":"Command 'telos' not found"},{"fix":"Add the file path: `// @telos L1:function:src/auth/validation:validateToken`","cause":"Missing the file path segment in the @telos annotation (requires 4 colon-separated parts).","error":"Error: Invalid @telos annotation format: L1:function:validateToken"},{"fix":"Open your project in Claude Code, OpenCode, or Cursor, then type `/telos:init` in the assistant chat.","cause":"Running slash commands in a terminal or unsupported AI assistant.","error":"telos-framework: Slash commands are not available in this environment"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/telos-framework/init#readme","github":"https://github.com/telos-framework/init","docs":null,"changelog":null,"pypi":null,"npm":"telos-framework","openapi_spec":null,"status_page":null,"smithery":null,"categories":["ai-ml","devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-04","next_check":"2026-09-02","install_tag":null}}