Akadata Limited
Get in Touch

AKADATA LIMITED

AKAMAN source: json.h

AKAMAN json.h — JSON parsing and protocol data handling.

AKAMAN logo

AKAMAN

A small Linux C utility that retrieves the compact documentation fragment an AI agent needs from the host where it is running.

Download AKAMAN v0.1.0 source →

main.c

CLI entry point, option parsing, and command dispatch. This is the released v0.1.0 source, shown in full so you can read it before downloading the archive.

Download source118 lines
#include "core.h"#include "mcp.h"#include <stdio.h>#include <stdlib.h>#include <string.h>#include <unistd.h>static const char *usage =    "akaman - minimal local man-page context for AI agents\n"    "\n"    "usage:\n"    "  akaman QUERY [SECTION]         query native man pages (source=man)\n"    "                                 SECTION numeric = man section, alphabetic = named section\n"    "  akaman -s SECTION QUERY        same\n"    "  akaman --source doc QUERY      query /usr/share/doc (README/FAQ/.txt/.md)\n"    "  akaman --source headers QUERY  query system headers (stdio.h printf)\n"    "  akaman --source man QUERY      query native man pages (default)\n"    "  akaman --stats QUERY [SECTION] print result plus token metrics\n"    "  akaman --mcp                   MCP stdio server (one tool: man)\n"    "  akaman --http[=ADDR] | --web[=ADDR]   webMCP HTTP server (default 127.0.0.1:8931)\n"    "                                 requires APIKEY in /etc/akaman/akamcp.conf\n"    "  akaman --conf PATH             config file path (APIKEY for webMCP)\n"    "  akaman --bench                 benchmark table\n"    "\n"    "  QUERY forms: command [option] | command [section-name] | command subcommand\n"    "    e.g. \"grep -r\"      -> the -r, --recursive option entry\n"    "         \"grep -rin\"    -> bundled short options decomposed (-r -i -n)\n"    "         \"grep examples\" -> the EXAMPLE section\n"    "         \"grep exit status\" -> the EXIT STATUS section\n"    "         \"passwd files\"  -> the FILES section\n"    "\n"    "  A bare command query returns the SYNOPSIS plus a one-line SECTIONS map\n"    "  (\"SECTIONS: A | B | ...\") for progressive disclosure. A query that\n"    "  matches nothing returns the available headings; option-like queries\n"    "  (starting -/--) additionally list the nearest real option names.\n"    "\n"    "examples:\n"    "  akaman \"ip link set\"\n"    "  akaman \"rsync --delete\"\n"    "  akaman -s 2 open\n";int main(int argc, char **argv) {	const char *conf = "/etc/akaman/akamcp.conf";	int mode = 0; /* 0 cli, 1 mcp, 2 http, 3 bench */	char httpaddr[256] = "127.0.0.1:8931";	const char *query = NULL;	const char *section = NULL;	const char *source = NULL;	int stats = 0;	for (int i = 1; i < argc; i++) {		char *a = argv[i];		if (strcmp(a, "--mcp") == 0) mode = 1;		else if (strcmp(a, "--bench") == 0) mode = 3;		else if (strcmp(a, "--stats") == 0) stats = 1;		else if (strncmp(a, "--source=", 9) == 0) source = a + 9;		else if (strcmp(a, "--source") == 0 && i + 1 < argc) source = argv[++i];		else if (strcmp(a, "--conf") == 0 && i + 1 < argc) conf = argv[++i];		else if (strcmp(a, "--web") == 0 || strcmp(a, "--http") == 0) {			mode = 2;			if (i + 1 < argc && argv[i + 1][0] != '-')				strncpy(httpaddr, argv[++i], sizeof httpaddr - 1);		} else if (strncmp(a, "--http=", 7) == 0) {			mode = 2;			strncpy(httpaddr, a + 7, sizeof httpaddr - 1);		} else if (strncmp(a, "--web=", 6) == 0) {			mode = 2;			strncpy(httpaddr, a + 6, sizeof httpaddr - 1);		} else if (strcmp(a, "-s") == 0 && i + 1 < argc) {			section = argv[++i];		} else if (a[0] == '-' && a[1]) {			fprintf(stderr, "akaman: unknown option: %s\n", a);			fputs(usage, stderr);			return 2;		} else {			if (!query) query = a;			else if (!section) section = a;			else {				fprintf(stderr, "akaman: too many arguments\n");				return 2;			}		}	}	if (mode == 1) return run_stdio();	if (mode == 2) {		char key[512] = {0};		if (!conf_load(conf, key, sizeof key)) {			fprintf(stderr, "akaman: webMCP requires APIKEY defined in %s\n", conf);			return 1;		}		return run_http(httpaddr, key);	}	if (mode == 3) return run_bench();	if (!query) {		fputs(usage, stderr);		return 2;	}	result res;	memset(&res, 0, sizeof res);	int st = akaman_run(query, section, source, &res);	if (res.text.p) write(1, res.text.p, res.text.len);	if (stats) {		double reduction = res.full_bytes ? 100.0 * (1.0 - (double)res.text.len / (double)res.full_bytes) : 0.0;		fprintf(stderr,		        "page: %s(%s)\nfull bytes: %zu\nreturned bytes: %zu\nfull tokens(est): %zu\n"		        "returned tokens(est): %zu\n",		        res.pagename, res.pagesec, res.full_bytes, res.text.len,		        EST_TOKENS(res.full_bytes), EST_TOKENS(res.text.len));		if (reduction > 99.9) fprintf(stderr, "reduction: >99.9%%\n");		else fprintf(stderr, "reduction: %.1f%%\n", reduction);	}	result_free(&res);	return st ? 1 : 0;}

Back to AKAMAN source layout