openbash

npx add-mcp 'https://openbash.ai/api/mcp'

openbash

Programas Bash sobre dados. Uma linha de comando entra, uma resposta sai.

Os programas abaixo são comandos em um caminho, não endpoints. Há UMA chamada exec, e um pipeline de vários programas é uma única solicitação para ela. Eles compõem com pipes, redirecionamento e as ferramentas comuns do shell, então dois deles podem ser unidos sem um esquema para a junção.

Quais programas existem é decidido por CONTA, não por chamada. Uma vez que um é habilitado, toda sessão que essa conta abre o tem, e "help" lista exatamente esses: então "help" é a resposta autoritativa para "o que posso executar", não esta página.

Configurando-se

Se você é um agente lendo isto porque alguém colou um link para você, este é o passo que eles queriam dizer:

curl -fsSL https://openbash.ai/install.sh | sh -s -- --key sk_ob_...

Isso escreve https://openbash.ai/skill.md — como usar este shell, como instruções — em cada diretório de agente na máquina, verifica a chave executando um comando gratuito, e registra o servidor MCP abaixo com essa chave como um cabeçalho. Sem navegador, e nada para instalar: não há CLI, porque a API é uma chamada HTTP e curl já é seu cliente.

Sem uma chave, ele ainda instala a habilidade e informa onde obter uma. Com nenhuma chave, a porta MCP abaixo executa uma tela comum de consentimento OAuth.

Três portas, um shell

HTTP   POST https://openbash.ai/api/v1/exec   {"command": "..."}
MCP    ssh -p 38449 <your-key>@ssh.openbash.ai '<command>'/api/mcp            uma ferramenta bash (https://openbash.ai/api/mcp/sandbox adiciona ferramentas tipadas de arquivo, biblioteca e figura, para um harness hospedado)
SSH    ssh -p 38449 <your-key>@ssh.openbash.ai '<command>'

Elas são três maneiras de entrar no mesmo shell com escopo de conta, não três serviços. Qualquer que você use, os mesmos programas estão no caminho e a mesma chave decide quais.

Contrato de saída

• JSON na saída padrão, um objeto por linha, então jq compõe entre programas.
• Cada registro carrega source (de onde foi lido) e as_of (quando essa fonte estava atual). as_of NÃO é o momento em que você executou o comando.
• Uma figura derivada é marcada com "derived": true e carrega suas entradas. Uma figura que você não pode verificar é uma figura que você não deve usar.
• Ausência é um valor. Um programa que não encontra nada diz isso e sai com 3; ele não retorna um objeto vazio que é lido como zero.

Códigos de saída

0   resultados
1   erro de uso. A flag ou o argumento estava errado
2   não autorizado. O programa existe, mas esta chave não o tem
3   nenhum resultado encontrado. A consulta era válida e não correspondeu a nada
4   falha de dados upstream. A fonte não pôde ser lida

2 e 3 são respostas diferentes e isso importa: 3 significa que não há nada lá, 2 significa que você não tinha permissão para olhar.

Lendo os erros

Erros são a documentação. Uma flag não suportada nomeia as flags que são suportadas; um comando desconhecido nomeia as aproximações. Tente algo, leia a falha, adapte-se. Esse caminho é projetado para funcionar.

Descoberta

GET https://openbash.ai/api/v1/programs      o catálogo, incluindo programas que esta chave não tem
GET https://openbash.ai/api/v1/programs/{slug}/surface/{read}  a página navegável de um programa como dados, para os programas cuja entrada de catálogo carrega uma superfície
GET https://openbash.ai/api/openapi.json     a especificação OpenAPI para cada endpoint
<program> --help                          a definição de um programa

Mantendo-se atualizado

Novos programas são novas capacidades neste shell, e não há necessidade de reler o catálogo e fazer diff para encontrá-los.

GET https://openbash.ai/api/v1/changelog     o que foi adicionado e quando, mais recente primeiro, como JSON
GET https://openbash.ai/feed.xml             a mesma lista como Atom
GET https://openbash.ai/sitemap.xml          cada página, com a data em que mudou por último

A data de um programa é quando ele apareceu pela primeira vez, não quando o catálogo sincronizou por último, então uma entrada que é nova para você é genuinamente nova.

Programas

• mail: Escreva um rascunho no Gmail ou Outlook conectado desta conta. Nada é enviado.
• biotech: Estudos de biotecnologia direcionados como JSON: ensaios clínicos, rótulos e aprovações de medicamentos, registros de empresas, literatura.
• aero: Cada movimento de voo para um dia de aeroporto, mais resumos por terminal e por hora, como JSON.
• trade: Conhecimentos de embarque alfandegários dos EUA: as contrapartes de uma empresa, seus embarques e as empresas que já importam o que você fabrica.
• outreach: Empresas que correspondem a uma descrição, as pessoas nelas e seus endereços — publicados, derivados ou verificados contra um servidor de correio.
• social: Uma superfície sobre X, LinkedIn, Instagram e YouTube: perfis, postagens, comentários, reações e busca.
• realestate-us: Listagens de aluguel mescladas entre fontes, mais as tabelas HUD que decidem o que um aluguel subsidiado pode ser.
• realestate-in: Listagens de aluguel ao redor de um lugar em uma cidade indiana, mescladas entre backends e deduplicadas.
• places: Encontre um lugar descrevendo-o, obtenha seu id e coordenadas, depois busque como ele se parece.
• commerce: Texto de registros SEC por ticker, propriedade 13F e a consulta de nome para ticker que você precisa antes de qualquer um.
• ocr: Reconhecimento óptico de caracteres sobre um arquivo em uma unidade ou uma url. O documento inteiro, ou cada linha com onde ela está.
• vision: Um modelo de visão lê imagens de uma unidade ou uma url e responde em palavras: o que está nela, o que ela diz, se duas correspondem.
• dbq: SQL somente leitura contra o banco de dados conectado da conta, com resultados como CSV na saída padrão.
• rank: Posição de palavra-chave no Google e quem está acima de você.
• dns: Autenticação de correio, servidores de nomes e registro.
• webaddress: Categorias e subcategorias na forma de uma página inicial de classificados, cada uma contendo os endereços que valem a pena conhecer; pergunte a qualquer ramo por seus dez principais, local a um lugar.
• registry: Downloads npm, estrelas GitHub, forks e último push.
• series: O histórico que um programa de medição deixa para trás e em que direção ele foi.
• browser: Pesquise na web, pegue originais e conduza uma sessão de navegador ao vivo.
• pplx: O índice do Perplexity a partir do shell: resultados classificados para uma pergunta e as passagens de uma página que se relacionam com ela.
• pdftext: O texto de um PDF como markdown, com uma verificação de legibilidade que roda sem extrair.
• doctext: Texto de um doc, docx, ppt, pptx, rtf, odt, odp ou epub como markdown.
• blueprint: Um desenho escrito como SVG, renderizado como um PNG de blueprint e, se solicitado, arquivado sob uma URL que o documento incorpora.
• edi: X12 como CSV: a remessa 820 e o ajuste 812, com o código de motivo em cada linha.
• sheet: Células de planilha como CSV, de xls, xlsx, xlsm, xlsb ou ods.
• csv: Colunas, contagens, frequências, somas, médias, filtros e junções sobre CSV.
• jq: Filtre e reformule JSON, da maneira que cada programa aqui o emite.
• text: awk, sed, grep, rg, cut, tr, sort, uniq e o resto dos coreutils de texto, na jaula.
• files: cat, ls, find, cp, mv, mkdir, rm, stat, du, diff e os auxiliares de caminho.
• archive: gzip, tar e zip, mais base64, somas de verificação e hexdumps.

O shell

O que o shell É — os mounts nele, o que esta chave pode executar e a convenção para citar fontes em uma resposta — vem do próprio shell, não desta página. Execute help através de qualquer porta acima, ou solicite esta página com sua chave e ela será incluída aqui.